@thoughtspot/visual-embed-sdk 1.20.1 → 1.20.3

package/lib/src/types.d.ts

@@ -9,34 +9,64 @@
 /**
  * The authentication mechanism for allowing access to the
  * the embedded app
+ *
  * @group Authentication / Init
  */
 export declare enum AuthType {
     /**
-     * No authentication on the SDK. Passthrough to the embedded App. Alias for `Passthrough`.
+     * No authentication on the SDK. Passthrough to the embedded App. Alias for
+     * `Passthrough`.
+     *
+     * @example
+     * ```js
+     * init({
+     *   // ...
+     *   authType: AuthType.None,
+     *  });
+     * ```
      */
     None = "None",
     /**
-     * Passthrough SSO to the embedded App 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.
+     * Passthrough SSO to the embedded App 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.
+     *
      * @version: SDK: 1.15.0 | ThouhgtSpot: 8.8.0.cl
      */
     EmbeddedSSO = "EmbeddedSSO",
     /**
      * SSO using SAML
+     *
      * @deprecated Use {@link SAMLRedirect} instead
      * @hidden
      */
     SSO = "SSO_SAML",
     /**
      * SSO using SAML
+     *
      * @deprecated Use {@link SAMLRedirect} instead
      * @hidden
      */
     SAML = "SSO_SAML",
     /**
      * SSO using SAML
-     * Will make the host application redirect to the SAML Idp.
+     * Will make the host application redirect to the SAML Idp. Use this
+     * when the idp does not allow itself to be embedded.
+     *
+     * This redirects the host application to the SAML Idp. The host application
+     * will be redirected back to the ThoughtSpot app after authentication.
+     *
+     * @example
+     * ```js
+     * init({
+     *   // ...
+     *   authType: AuthType.SAMLRedirect,
+     *  });
+     * ```
+     *
+     * 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
      * ```js
      * init({
@@ -44,12 +74,29 @@ export declare enum AuthType {
      *   authType: AuthType.SAMLRedirect,
      *   authTriggerText: 'Login with SAML',
      *   authTriggerContainer: '#embed-container',
-     *  });
+     *   inPopup: true,
+     * });
+     * ```
+     *
+     * Can also use event to trigger the popup flow. Works the same
+     * as above example.
+     * @example
+     * ```js
+     * const authEE = init({
+     *  // ...
+     *  authType: AuthType.SAMLRedirect,
+     *  inPopup: true,
+     * });
+     *
+     * someButtonOnYourPage.addEventListener('click', () => {
+     *  authEE.emit(AuthEvent.TRIGGER_SSO_POPUP);
+     * });
      * ```
      */
     SAMLRedirect = "SSO_SAML",
     /**
      * SSO using OIDC
+     *
      * @hidden
      * @deprecated Use {@link OIDCRedirect} instead
      */
@@ -57,18 +104,20 @@ export declare enum AuthType {
     /**
      * SSO using OIDC
      * Will make the host application redirect to the OIDC Idp.
+     * See code samples in {@link SAMLRedirect}.
      */
     OIDCRedirect = "SSO_OIDC",
     /**
      * Trusted authentication server
+     *
      * @hidden
      * @deprecated Use {@link TrustedAuth} instead
      */
     AuthServer = "AuthServer",
     /**
      * Trusted authentication server, Use your own authentication server
-     * which returns a bearer token, generated using the secret_key obtained from
-     * ThoughtSpot.
+     * which returns a bearer token, generated using the secret_key obtained
+     * from ThoughtSpot.
      *
      * @example
      * ```js
@@ -84,10 +133,24 @@ 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 obtained from
-     * ThoughtSpot. This uses a cookieless authentication approach, recommended
-     * to by pass third-party cookie-blocking restriction implemented by some browsers
+     * Trusted authentication server Cookieless, Use you 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
+     *
+     * @example
+     * ```js
+     * init({
+     *  // ...
+     *  authType: AuthType.TrustedAuthTokenCookieless,
+     *  getAuthToken: () => {
+     *    return fetch('https://my-backend.app/ts-token')
+     *      .then((response) => response.json())
+     *      .then((data) => data.token);
+     *  }
+     * ```
+     * @version SDK: 1.22.0| ThouhgtSpot: 9.3.0.cl, 9.5.1-sw
      */
     TrustedAuthTokenCookieless = "AuthServerCookieless",
     /**
@@ -190,8 +253,8 @@ export interface EmbedConfig {
      */
     getAuthToken?: () => Promise<string>;
     /**
-     * [AuthServer / Basic] The user name of the ThoughtSpot user. This attribute is
-     * required for trusted authentication.
+     * [AuthServer / Basic] The user name of the ThoughtSpot user. This
+     * attribute is required for trusted authentication.
      */
     username?: string;
     /**
@@ -202,16 +265,20 @@ 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 place.
+     * [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
+     * place.
      *
      * @default false
      * @deprecated
      */
     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.
+     * [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.
+     *
+     * 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
@@ -223,6 +290,7 @@ export interface EmbedConfig {
      * terminated.
      *
      * Eg: "/dashboard", "#/foo" [Do not include the host]
+     *
      * @version SDK: 1.10.2 | 8.2.0.cl, 8.4.1-sw
      */
     redirectPath?: string;
@@ -232,43 +300,52 @@ export interface EmbedConfig {
      * 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.
+     *
      * @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
+     * 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
      * in this case.
+     *
      * @default false
      */
     suppressNoCookieAccessAlert?: boolean;
     /**
      * Re-login when session expires with the previous login options
+     *
      * @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 auth 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.
+     *
      * @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
+     *
      * @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.
+     *  after the previous embed's render is complete. This helps in the load
+     *  performance by decreasing the load on the browser.
+     *
      *  @Version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      * @default false
      */
@@ -276,15 +353,19 @@ export interface EmbedConfig {
     /**
      * 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
      * @default ''
      */
     customCssUrl?: string;
     /**
-     * [AuthServer|Basic] Detect if 3rd 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.
+     * [AuthServer|Basic] Detect if 3rd 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.
+     *
+     * This is slightly slower than letting the browser handle the cookie check, as it
+     * involves an extra network call.
      *
-     * This is slightly slower than letting the browser handle the cookie check, as it involves an extra network call.
      * @version SDK: 1.10.4 | ThoughtSpot: 8.2.0.cl, 8.4.1-sw
      */
     detectCookieAccessSlow?: boolean;
@@ -301,16 +382,32 @@ export interface EmbedConfig {
      */
     customizations?: CustomisationsInterface;
     /**
-     * For noRedirect SSO Auth, we need a button which the user
+     * 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.
      *
+     * @example
+     * ```js
+     * init({
+     *   authType: AuthType.SAMLRedirect,
+     *   inPopup: true,
+     *   authTriggerContainer: '#auth-trigger-container'
+     * })
+     * ```
      * @version SDK: 1.17.0 | ThoughtSpot: *
      */
     authTriggerContainer?: string | HTMLElement;
+    /**
+     * 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.
+     *
+     */
+    useEventForSAMLPopup?: boolean;
     /**
      * Text to show in the button which triggers the popup auth flow.
      * Default: "Authorize".
+     *
      * @version SDK: 1.17.0 | ThoughtSpot: *
      */
     authTriggerText?: string;
@@ -352,7 +449,8 @@ export interface ViewConfig {
      */
     layoutConfig?: LayoutConfig;
     /**
-     * The <b>width</b> and <b>height</b> dimensions to render an embedded object inside your app.  Specify the values in pixels or percentage.
+     * The <b>width</b> and <b>height</b> dimensions to render an embedded
+     * object inside your app.  Specify the values in pixels or percentage.
      */
     frameParams?: FrameParams;
     /**
@@ -365,7 +463,17 @@ export interface ViewConfig {
     styleSheet__unstable?: string;
     /**
      * The list of actions to disable from the primary menu, more menu
-     * (...), and the contextual menu.
+     * (...), and the contextual menu. These actions will be disabled
+     * for the user.
+     * Use this to disable actions.
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed', {
+     *   ... // other liveboard view config
+     *   disabledActions: [Action.Download, Action.Save]
+     * });
+     * ```
      */
     disabledActions?: Action[];
     /**
@@ -373,18 +481,35 @@ export interface ViewConfig {
      */
     disabledActionReason?: string;
     /**
-     * The list of actions to hide from the primary menu, more menu
-     * (...), and the contextual menu.
+     * The list of actions to hide from the embedded.
+     * This actions will be hidden from the user.
+     * Use this to hide an action.
+     *
+     * @example
+     * ```js
+     * const embed = new LiveboardEmbed('#embed', {
+     *   ... // other liveboard view config
+     *   hiddenActions: [Action.Download, Action.Export]
+     * });
+     * ```
+     * @important
      */
     hiddenActions?: Action[];
     /**
      * The list of actions to display from the primary menu, more menu
-     * (...), and the contextual menu.
+     * (...), and the contextual menu. These will be only actions that
+     * are visible to the user.
+     * Use this to hide all actions except the ones you want to show.
+     *
+     * Use either this or hiddenActions.
+     *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
+     * @important
      */
     visibleActions?: Action[];
     /**
      * Show alert messages and toast messages in the embedded view.
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     showAlerts?: boolean;
@@ -395,6 +520,7 @@ export interface ViewConfig {
     runtimeFilters?: RuntimeFilter[];
     /**
      * The locale/language to use for the embedded view.
+     *
      * @version SDK: 1.9.4 | ThoughtSpot 8.1.0.cl, 8.4.1-sw
      */
     locale?: string;
@@ -405,6 +531,7 @@ export interface ViewConfig {
      * Warning: This option is for advanced use only and is used internally
      * to control embed behavior in non-regular ways. We do not publish the
      * list of supported keys and values associated with each.
+     *
      * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1-sw
      */
     additionalFlags?: {
@@ -413,33 +540,49 @@ export interface ViewConfig {
     /**
      * Dynamic CSSUrl and customCSS to be injected in the loaded application.
      * You would also need to set `style-src` in the CSP settings.
+     *
      * @version SDK: 1.17.2 | ThoughtSpot: 8.4.1-sw, 8.4.0.cl
      * @default ''
      */
     customizations?: CustomisationsInterface;
     /**
-     * Insert as a sibling of the target container, instead of appending to a child inside it.
+     * Insert as a sibling of the target container, instead of appending to a
+     * child inside it.
      */
     insertAsSibling?: boolean;
     /**
      * flag to set ContextMenu Trigger to either left or right click.
+     *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     contextMenuTrigger?: ContextMenuTriggerOptions;
     /**
      * flag to override openNew tab context menu link
+     *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     linkOverride?: boolean;
     /**
      * flag to enable insert into slides action
+     *
      * @hidden
      * @private
      */
     insertInToSlide?: boolean;
+    /**
+     * Use a pre-rendered iframe from a pool of pre-rendered iframes
+     * if available and matches the configuration.
+     *
+     * @version SDK: 1.22.0
+     * @hidden
+     *
+     * See [docs]() on how to create a prerender pool.
+     */
+    usePrerenderedIfAvailable?: boolean;
 }
 /**
  * MessagePayload: Embed event payload: message type, data and status (start/end)
+ *
  * @group Events
  */
 export type MessagePayload = {
@@ -448,21 +591,37 @@ export type MessagePayload = {
     status?: string;
 };
 /**
- * MessageOptions: By Providing options, getting specific event start / end based on option
+ * MessageOptions: By Providing options, getting specific event start / end based on
+ * option
+ *
  * @group Events
  */
 export type MessageOptions = {
+    /**
+     *  A boolean value indicating that start status events of this type
+     *  will be dispatched
+     */
     start?: boolean;
 };
 /**
  * MessageCallback: Embed event message callback
+ *
  * @group Events
  */
-export type MessageCallback = (payload: MessagePayload, responder?: (data: any) => void) => void;
+export type MessageCallback = (payload: MessagePayload, 
+/**
+ *  responder: Message callback function triggered when embed event
+ *  initiated
+ */
+responder?: (data: any) => void) => void;
 /**
  * MessageCallbackObj: contains message options & callback function
  */
 export type MessageCallbackObj = {
+    /**
+     *  options: It contains start, A boolean value indicating that start
+     *  status events of this type will be dispatched
+     */
     options: MessageOptions;
     callback: MessageCallback;
 };
@@ -546,7 +705,8 @@ export interface RuntimeFilter {
     operator: RuntimeFilterOp;
     /**
      * The list of operands. Some operators like EQ, LE accept
-     * a single operand, whereas other operators like BW and IN accept multiple operands.
+     * a single operand, whereas other operators like BW and IN accept multiple
+     * operands.
      */
     values: (number | boolean | string)[];
 }
@@ -555,82 +715,122 @@ export interface RuntimeFilter {
  *
  * To add an event listener use the corresponding
  * {@link LiveboardEmbed.on} or {@link AppEmbed.on} or {@link SearchEmbed.on} method.
+ *
+ *  @example
+ * ```js
+ * import { EmbedEvent } from '@thoughtspot/visual-embed-sdk';
+ * // Or
+ * // const { EmbedEvent } = window.tsembed;
+ *
+ * // create the liveboard embed.
+ *
+ * liveboardEmbed.on(EmbedEvent.Drilldown, (drilldown) => {
+ *   console.log('Drilldown event', drilldown);
+ * }));
+ * ```
  * @group Events
  */
 export declare enum EmbedEvent {
     /**
      * Rendering has initialized.
-     * @return timestamp - The timestamp when the event was generated.
+     *
+     * @returns timestamp - The timestamp when the event was generated.
      */
     Init = "init",
     /**
      * Authentication has either succeeded or failed.
-     * @return isLoggedIn - A Boolean specifying whether authentication was successful.
+     *
+     * @returns isLoggedIn - A Boolean specifying whether authentication was successful.
      */
     AuthInit = "authInit",
     /**
      * The embed object container has loaded.
-     * @return timestamp - The timestamp when the event was generated.
+     *
+     * @returns timestamp - The timestamp when the event was generated.
      */
     Load = "load",
     /**
      * Data pertaining to answer or Liveboard is received
+     *
      * @return data - The answer or Liveboard data
+     * @important
      */
     Data = "data",
     /**
-     * Search/answer/Liveboard filters have been applied/updated
+     * Search/answer/Liveboard filters have been applied/updated by the user.
+     *
      * @hidden
      */
     FiltersChanged = "filtersChanged",
     /**
-     * Search query has been updated
+     * Search query has been updated by the user.
      */
     QueryChanged = "queryChanged",
     /**
      * A drill down operation has been performed.
-     * @return additionalFilters - Any additional filters applied
-     * @return drillDownColumns - The columns on which drill down was performed
-     * @return nonFilteredColumns - The columns that were not filtered
+     *
+     * @returns additionalFilters - Any additional filters applied
+     * @returns drillDownColumns - The columns on which drill down was performed
+     * @returns nonFilteredColumns - The columns that were not filtered
      */
     Drilldown = "drillDown",
     /**
      * One or more data sources have been selected.
-     * @return dataSourceIds - the list of data sources
+     *
+     * @returns dataSourceIds - the list of data sources
      */
     DataSourceSelected = "dataSourceSelected",
     /**
      * One or more data columns have been selected.
-     * @return columnIds - the list of columns
+     *
+     * @returns columnIds - the list of columns
      * @version SDK: 1.10.0 | ThoughtSpot: 8.2.0.cl, 8.4.1-sw
      */
     AddRemoveColumns = "addRemoveColumns",
     /**
      * A custom action has been triggered
-     * @return actionId - The id of the custom action
-     * @return data - The answer or Liveboard data
+     *
+     * @returns actionId - The id of the custom action
+     * @returns data - The answer or Liveboard data
      */
     CustomAction = "customAction",
     /**
-     * A double click has been triggered on table/chart
+     * Listen to double clicks on a visualization
+     *
      * @return ContextMenuInputPoints - data point that is double clicked
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      */
     VizPointDoubleClick = "vizPointDoubleClick",
     /**
-     * A click has been triggered on table/chart
-     * @return ContextMenuInputPoints - data point that is clicked
+     * Listen to clicks on a visualization in a liveboard or Search result.
+     *
+     * @example
+     * ```js
+     * embed.on(ThoughtSpotEmbed.Event.VizPointClick, ({data}) => {
+     *   console.log(
+     *    data.vizId, // viz id
+     *    data.clickedPoint.selectedAttributes[0].value,
+     *    data.clickedPoint.selectedAttributes[0].column.name,
+     *    data.clickedPoint.selectedMeasures[0].value,
+     *    data.clickedPoint.selectedMeasures[0].column.name,
+     *   )
+     * });
+     * ```
+     * @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.
-     * @return error - An error object or message
+     *
+     * @returns error - An error object or message
      */
     Error = "Error",
     /**
      * The embedded object has sent an alert
-     * @return alert - An alert object
+     *
+     * @returns alert - An alert object
      */
     Alert = "alert",
     /**
@@ -639,29 +839,34 @@ export declare enum EmbedEvent {
     AuthExpire = "ThoughtspotAuthExpired",
     /**
      * ThoughtSpot failed to validate the auth session.
+     *
      * @hidden
      */
     AuthFailure = "ThoughtspotAuthFailure",
     /**
      * ThoughtSpot failed to validate the auth session.
+     *
      * @hidden
      */
     AuthLogout = "ThoughtspotAuthLogout",
     /**
      * The height of the embedded Liveboard or visualization has been computed.
-     * @return data - The height of the embedded Liveboard or visualization
+     *
+     * @returns data - The height of the embedded Liveboard or visualization
      * @hidden
      */
     EmbedHeight = "EMBED_HEIGHT",
     /**
      * The center of visible iframe viewport is calculated.
-     * @return data - The center of the visible Iframe viewport.
+     *
+     * @returns data - The center of the visible Iframe viewport.
      * @hidden
      */
     EmbedIframeCenter = "EmbedIframeCenter",
     /**
      * Emitted when  the "Get Data" button in Search Bar embed
      * is clicked.
+     *
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.0-sw
      */
     GetDataClick = "getDataClick",
@@ -671,6 +876,7 @@ export declare enum EmbedEvent {
     RouteChange = "ROUTE_CHANGE",
     /**
      * The v1 event type for Data
+     *
      * @hidden
      */
     V1Data = "exportVizDataToParent",
@@ -683,17 +889,20 @@ export declare enum EmbedEvent {
     NoCookieAccess = "noCookieAccess",
     /**
      * Emitted when SAML is complete
+     *
      * @private
      * @hidden
      */
     SAMLComplete = "samlComplete",
     /**
      * Emitted when any modal is opened in the app
+     *
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
      */
     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
      */
     DialogClose = "dialog-close",
@@ -701,192 +910,256 @@ export declare enum EmbedEvent {
      * 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
      */
     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
      */
     ALL = "*",
     /**
      * Emitted when answer is saved in the app
+     *
      * @Version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     Save = "save",
     /**
      * Emitted when the download action is triggered on an answer
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     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
+     */
+    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
      */
     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
      */
     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
      */
     DownloadAsXlsx = "downloadAsXlsx",
     /**
      * Emitted when an answer is deleted in the app
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     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
      */
     Pin = "pin",
     /**
      * Emitted when SpotIQ analysis is triggered
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     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
      */
     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
      */
     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
      */
     DrillExclude = "context-menu-item-exclude",
     /**
      * Emitted when copied column value on the app
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     CopyToClipboard = "context-menu-item-copy-to-clipboard",
     /**
      * Emitted when a user clicks the Update TML action
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     UpdateTML = "updateTSL",
     /**
      * Emitted when a user clicks the Edit TML action
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     EditTML = "editTSL",
     /**
      * Emitted when ExportTML trigger in answer on the app
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     ExportTML = "exportTSL",
     /**
      * Emitted when an answer is saved as a view
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     SaveAsView = "saveAsView",
     /**
      * Emitted when copy of existing answer on the app
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     CopyAEdit = "copyAEdit",
     /**
      * Emitted when a user clicks Show underlying data on an answe
+     *
      * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1-sw
      */
     ShowUnderlyingData = "showUnderlyingData",
     /**
      * 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
      */
     AnswerChartSwitcher = "answerChartSwitcher",
     /**
      * Internal event to communicate the initial settings back to the TS APP
+     *
      * @hidden
      */
     APP_INIT = "appInit",
     /**
      * 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
      */
     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
      */
     AddToFavorites = "addToFavorites",
     /**
      * Emitted when a user clicks Schedule on a Liveboard
+     *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     Schedule = "subscription",
     /**
      * 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
      */
     Edit = "edit",
     /**
      * 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
      */
     MakeACopy = "makeACopy",
     /**
      * 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
      */
     Present = "present",
     /**
      * Emitted when a user clicks Delete on a Liveboard
+     *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     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
      */
     SchedulesList = "schedule-list",
     /**
      * 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
      */
     Cancel = "cancel",
     /**
      * Emitted when a user clicks Explore on a visualization
+     *
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     Explore = "explore",
     /**
      * 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
      */
     CopyLink = "embedDocument",
     /**
      * Emitted when a user interacts with cross filters on a visualization or liveboard
+     *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     CrossFilterChanged = "cross-filter-changed",
     /**
-     * Emitted when a user right clicks on chart or table
+     * Emitted when a user right clicks on a visualization (chart or table)
+     *
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
-    VizPointRightClick = "vizPointRightClick"
+    VizPointRightClick = "vizPointRightClick",
+    /**
+     * Emitted when a user clicks on Insert to slide on a visualization
+     *
+     * @hidden
+     */
+    InsertIntoSlide = "insertInToSlide"
 }
 /**
  * Event types that can be triggered by the host application
  * to the embedded ThoughtSpot app
  *
  * To trigger an event use the corresponding
- * {@link LiveboardEmbed.trigger} or {@link AppEmbed.trigger} or {@link SearchEmbed.trigger} method.
+ * {@link LiveboardEmbed.trigger} or {@link AppEmbed.trigger} or {@link
+ * SearchEmbed.trigger} method.
+ *
+ * @example
+ * ```js
+ * import { HostEvent } from '@thoughtspot/visual-embed-sdk';
+ * // Or
+ * // const { HostEvent } = window.tsembed;
+ *
+ * // create the liveboard embed.
+ *
+ * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
+ *   { columnName: 'state, operator: RuntimeFilterOp.EQ, values: ['california']}
+ * ]);
+ * ```
  * @group Events
  */
 export declare enum HostEvent {
     /**
      * Trigger a search
+     *
      * @param - dataSourceIds - The data source GUID to Search on
      *                        - Although an array, only a single source
      *                          is supported at this time.
@@ -896,7 +1169,7 @@ export declare enum HostEvent {
      * ```js
      * searchEmbed.trigger(HostEvent.Search, {
      *   searchQuery: "[sales] by [item type],
-     *   dataSourceIds: ["cd252e5c-b552-49a8-821d-3eadaa049cca"]
+     *   dataSources: ["cd252e5c-b552-49a8-821d-3eadaa049cca"]
      *   execute: true
      * })
      * ```
@@ -904,55 +1177,77 @@ export declare enum HostEvent {
     Search = "search",
     /**
      * Trigger a drill on certain points by certain column
+     *
      * @param - points - an object containing selectedPoints/clickedPoints
      *              eg. { selectedPoints: []}
      * @param - columnGuid - a string guid of the column to drill by. This is optional,
-     *                     if not provided it will auto drill by the configured column.
+     *                     if not provided it will auto drill by the configured
+     *                     column.
      * @example
      * ```js
-     * searchEmbed.trigger(HostEvent.DrillDown, {
-     *   points: clickedPointData,
-     *   autoDrillDown: true,
+     * searchEmbed.on(EmbedEvent.VizPointDoubleClick, (payload) => {
+     *       console.log(payload);
+     *       const clickedPoint = payload.data.clickedPoint;
+     *       const selectedPoint = payload.data.selectedPoints;
+     *       console.log('>>> called', clickedPoint);
+     *       searchEmbed.trigger(HostEvent.DrillDown, {
+     *             points: {
+     *                  clickedPoint,
+     *                  selectedPoints: selectedPoint
+     *             },
+     *             autoDrillDown: true,
+     *       });
      * })
      * ```
-     *
      * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
      */
     DrillDown = "triggerDrillDown",
     /**
      * Apply filters
+     *
      * @hidden
      */
     Filter = "filter",
     /**
      * Reload the answer or visualization
+     *
      * @hidden
      */
     Reload = "reload",
     /**
      * Set the visible visualizations on a Liveboard.
+     *
      * @param - an array of ids of visualizations to show, the ids not passed
      *          will be hidden.
      * @example
-     * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, ['730496d6-6903-4601-937e-2c691821af3c', 'd547ec54-2a37-4516-a222-2b06719af726'])
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, [
+     *  '730496d6-6903-4601-937e-2c691821af3c',
+     *  'd547ec54-2a37-4516-a222-2b06719af726'])
+     * ```
      * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1-sw
      */
     SetVisibleVizs = "SetPinboardVisibleVizs",
     /**
      * Update the runtime filters. The runtime filters passed here are extended
      * on to the existing runtime filters if they exist.
+     *
      * @param - {@link RuntimeFilter}[] an array of {@link RuntimeFilter} Types.
      * @example
+     * ```js
      * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
-     * {columnName: "state",operator: RuntimeFilterOp.EQ,values: ["michigan"]},
-     * {columnName: "item type",operator: RuntimeFilterOp.EQ,values: ["Jackets"]}
+     *   {columnName: "state",operator: RuntimeFilterOp.EQ,values: ["michigan"]},
+     *   {columnName: "item type",operator: RuntimeFilterOp.EQ,values: ["Jackets"]}
      * ])
+     * ```
      * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1-sw
+     * @important
      */
     UpdateRuntimeFilters = "UpdateRuntimeFilters",
     /**
      * Navigate to a specific page in App embed without any reload.
      * 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)
      * @example
      * ```js
@@ -964,16 +1259,22 @@ export declare enum HostEvent {
     /**
      * Opens the filter panel for a particular column.
      * Works with Search embed.
-     * @param - { columnId: string, name: string, type: INT64/CHAR/DATE, dataType: ATTRIBUTE/MEASURE }
+     *
+     * @param - { columnId: string,
+     *  name: string,
+     *  type: INT64/CHAR/DATE,
+     *  dataType: ATTRIBUTE/MEASURE }
      * @example
      * ```js
-     * searchEmbed.trigger(HostEvent.OpenFilter, { columnId: '123', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE' })
+     * searchEmbed.trigger(HostEvent.OpenFilter,
+     *  { columnId: '123', name: 'column name', type: 'INT64', dataType: 'ATTRIBUTE' })
      * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
      */
     OpenFilter = "openFilter",
     /**
      * Adds the columns to the current Search.
+     *
      * @param - { columnIds: string[] }
      * @example
      * ```js
@@ -984,6 +1285,7 @@ export declare enum HostEvent {
     AddColumns = "addColumns",
     /**
      * Removes a column from the current Search.
+     *
      * @param - { columnId: string }
      * @example
      * ```js
@@ -994,6 +1296,7 @@ export declare enum HostEvent {
     RemoveColumn = "removeColumn",
     /**
      * Gets the current pinboard content.
+     *
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard)
@@ -1003,6 +1306,7 @@ export declare enum HostEvent {
     getExportRequestForCurrentPinboard = "getExportRequestForCurrentPinboard",
     /**
      * Triggers the Pin action on an embedded object
+     *
      * @param - incase of Liveboard embed, takes in an object with vizId as a key
      * can be left empty for search and visualization embeds
      * @example
@@ -1016,6 +1320,7 @@ export declare enum HostEvent {
     Pin = "pin",
     /**
      * Triggers the Show Liveboard details action on a Liveboard
+     *
      * @example
      * ```js
      *  liveboardEmbed.trigger(HostEvent.LiveboardInfo)
@@ -1025,6 +1330,7 @@ export declare enum HostEvent {
     LiveboardInfo = "pinboardInfo",
     /**
      * Triggers the Schedule action on a Liveboard
+     *
      * @example
      * ```js
      *  liveboardEmbed.trigger(HostEvent.Schedule)
@@ -1034,6 +1340,7 @@ export declare enum HostEvent {
     Schedule = "subscription",
     /**
      * Triggers the Manage schedule action on a Liveboard
+     *
      * @example
      * ```js
      *  liveboardEmbed.trigger(HostEvent.ScheduleList)
@@ -1043,6 +1350,7 @@ export declare enum HostEvent {
     SchedulesList = "schedule-list",
     /**
      * Triggers the Export TML action on a Liveboard
+     *
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.ExportTML)
@@ -1052,6 +1360,7 @@ export declare enum HostEvent {
     ExportTML = "exportTSL",
     /**
      * Triggers the Edit TML action on a Liveboard
+     *
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.EditTML)
@@ -1061,6 +1370,7 @@ export declare enum HostEvent {
     EditTML = "editTSL",
     /**
      * Triggers the Update TML action on a Liveboard
+     *
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.UpdateTML)
@@ -1070,15 +1380,17 @@ export declare enum HostEvent {
     UpdateTML = "updateTSL",
     /**
      * Triggers the Download PDF action on a Liveboard
+     *
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.DownloadAsPDF)
+     * liveboardEmbed.trigger(HostEvent.DownloadAsPdf)
      * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     DownloadAsPdf = "downloadAsPdf",
     /**
      * Triggers the Make a copy action on a Liveboard, search or visualization
+     *
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.MakeACopy, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
@@ -1090,6 +1402,7 @@ export declare enum HostEvent {
     MakeACopy = "makeACopy",
     /**
      * Triggers the Delete action on a Liveboard
+     *
      * @example
      * ```js
      * appEmbed.trigger(HostEvent.Remove)
@@ -1099,6 +1412,7 @@ export declare enum HostEvent {
     Remove = "delete",
     /**
      * Triggers the Explore action on a visualization
+     *
      * @param - an object with vizId as a key
      * @example
      * ```js
@@ -1109,37 +1423,52 @@ export declare enum HostEvent {
     Explore = "explore",
     /**
      * Triggers the Create alert action on a visualization
+     *
      * @param - an object with vizId as a key
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.CreateMonitor {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * liveboardEmbed.trigger(HostEvent.CreateMonitor {
+     *  vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * })
      * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     CreateMonitor = "createMonitor",
     /**
      * Triggers the Manage alert action on a visualization
+     *
      * @param - an object with vizId as a key
      * @example
      * ```js
-     * liveboardEmbed.trigger(HostEvent.ManageMonitor, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * liveboardEmbed.trigger(HostEvent.ManageMonitor, {
+     *  vizId: '730496d6-6903-4601-937e-2c691821af3c'
+     * })
      * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     ManageMonitor = "manageMonitor",
     /**
      * Triggers the Edit action on a Liveboard or visualization
-     * @param - object - to trigger the action for a specfic visualization in Liveboard embed, pass in vizId as a key
+     *
+     * @param - object - to trigger the action for a specfic visualization
+     *   in Liveboard embed, pass in vizId as a key
      * @example
+     * ```js
      * liveboardEmbed.trigger(HostEvent.Edit)
-     * liveboardEmbed.trigger(HostEvent.Edit, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     *
+     * liveboardEmbed.trigger(HostEvent.Edit, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger((HostEvent.Edit)
+     * ```
      * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1-sw
      */
     Edit = "edit",
     /**
      * Triggers the Copy link action on a Liveboard or visualization
-     * @param - object - to trigger the action for a specfic visualization in Liveboard embed, pass in vizId as a key
+     *
+     * @param - object - to trigger the action for a s
+     *  pecfic visualization in Liveboard embed, pass in vizId as a key
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.CopyLink)
@@ -1151,7 +1480,9 @@ export declare enum HostEvent {
     CopyLink = "embedDocument",
     /**
      * Triggers the Present action on a Liveboard or visualization
-     * @param - object - to trigger the action for a specfic visualization in Liveboard embed, pass in vizId as a key
+     *
+     * @param - object - to trigger the action for a specfic visualization
+     *  in Liveboard embed, pass in vizId as a key
      * @example
      * ```js
      * liveboardEmbed.trigger(HostEvent.Present)
@@ -1163,119 +1494,203 @@ export declare enum HostEvent {
     Present = "present",
     /**
      * Get TML for the current search.
+     *
      * @example
      * ```js
-     * searchEmbed.trigger(HostEvent.GetTML)
+     * searchEmbed.trigger(HostEvent.GetTML).then((tml) => {
+     *   console.log(
+     *      tml.search_query // TML representation of the search query
+     *   );
+     * })
      * ```
      * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1-sw
+     * @important
      */
     GetTML = "getTML",
     /**
      * Triggers the ShowUnderlyingData action on visualization or search
+     *
      * @param - an object with vizId as a key
      * @example
-     * liveboardEmbed.trigger(HostEvent.ShowUnderlyingData, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.ShowUnderlyingData, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.ShowUnderlyingData)
+     *
      * searchEmbed.trigger(HostEvent.ShowUnderlyingData)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     ShowUnderlyingData = "showUnderlyingData",
     /**
      * Triggers the Delete action on visualization or search
+     *
      * @param - incase of Liveboard embed, takes in an object with vizId as a key
      * can be left empty for search and visualization embeds
      * @example
-     * liveboardEmbed.trigger(HostEvent.Delete, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.Delete, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.Delete)
+     *
      * searchEmbed.trigger(HostEvent.Delete)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
-    Delete = "delete",
+    Delete = "onDeleteAnswer",
     /**
      * Triggers the SpotIQAnalyze action on visualization or search
+     *
      * @param - incase of Liveboard embed, takes in an object with vizId as a key
      * can be left empty for search and visualization embeds
      * @example
-     * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.SpotIQAnalyze)
+     *
      * searchEmbed.trigger(HostEvent.SpotIQAnalyze)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     SpotIQAnalyze = "spotIQAnalyze",
     /**
      * Triggers the Download action on visualization or search when Displaymode is Chart
+     *
      * @example
-     * liveboardEmbed.trigger(HostEvent.Download, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.Download, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.Download)
+     *
      * searchEmbed.trigger(HostEvent.Download)
+     * ```
+     * @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 = "download",
+    Download = "downloadAsPng",
     /**
-     * Triggers the downloadAsCSV action on visualization or search when Displaymode is Table
+     * Triggers the Download action on visualization or search when Displaymode is Chart
+     *
      * @example
-     * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.DownloadAsPng,
+     * {vizId:'730496d6-6903-4601-937e-2c691821af3c'})
+     *
+     * vizEmbed.trigger(HostEvent.DownloadAsPng)
+     *
+     * searchEmbed.trigger(HostEvent.DownloadAsPng)
+     * ```
+     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.1-sw
+     */
+    DownloadAsPng = "downloadAsPng",
+    /**
+     * Triggers the downloadAsCSV action on visualization or search
+     *
+     * @example
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.DownloadAsCsv)
+     *
      * searchEmbed.trigger(HostEvent.DownloadAsCsv)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     DownloadAsCsv = "downloadAsCSV",
     /**
-     * Triggers the downloadAsXLSX action on visualization or search when Displaymode is Table
+     * Triggers the downloadAsXLSX action on visualization or search
+     *
      * @example
-     * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.DownloadAsXlsx)
+     *
      * searchEmbed.trigger(HostEvent.DownloadAsXlsx)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     DownloadAsXlsx = "downloadAsXLSX",
     /**
      * Triggers the Share action on a liveboard or answer
+     *
      * @example
+     * ```js
      * liveboardEmbed.trigger(HostEvent.Share)
+     *
      * searchEmbed.trigger(HostEvent.Share)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     Share = "share",
     /**
      * Trigger the Save action on a liveboard or answer
+     *
      * @example
+     * ```js
      * liveboardEmbed.trigger(HostEvent.Save)
+     *
      * searchEmbed.trigger(HostEvent.Save)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     Save = "save",
     /**
      * Triggers the SyncToSheets action on visualization
+     *
      * @param - an object with vizId as a key
      * @example
-     * liveboardEmbed.trigger(HostEvent.SyncToSheets, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.SyncToSheets, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.SyncToSheets)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     SyncToSheets = "sync-to-sheets",
     /**
      * Triggers the SyncToOtherApps action on visualization
+     *
      * @param - an object with vizId as a key
      * @example
-     * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.SyncToOtherApps)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     SyncToOtherApps = "sync-to-other-apps",
     /**
      * Triggers the ManagePipelines action on visualization
+     *
      * @param - an object with vizId as a key
      * @example
-     * liveboardEmbed.trigger(HostEvent.ManagePipelines, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
+     * ```js
+     * liveboardEmbed.trigger(HostEvent.ManagePipelines, {vizId:
+     * '730496d6-6903-4601-937e-2c691821af3c'})
+     *
      * vizEmbed.trigger(HostEvent.ManagePipelines)
+     * ```
      * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1-sw
      */
     ManagePipelines = "manage-pipeline",
     /**
      * Triggers the Reset search in answer
+     *
      * @example
-     * searchEmbed.trigger(HostEvent.SearchReset
+     * ```js
+     * searchEmbed.trigger(HostEvent.ResetSearch)
+     * ```
      * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1-sw
      */
     ResetSearch = "resetSearch"
@@ -1303,6 +1718,7 @@ export declare enum DataSourceVisualMode {
  * containing configuration and/or visual information.
  */
 export declare enum Param {
+    EmbedApp = "embedApp",
     DataSources = "dataSources",
     DataSourceMode = "dataSourceMode",
     DisableActions = "disableAction",
@@ -1341,11 +1757,26 @@ export declare enum Param {
     cookieless = "cookieless",
     ContextMenuTrigger = "isContextMenuEnabledOnLeftClick",
     LinkOverride = "linkOverride",
-    ShowInsertToSlide = "insertInToSlide"
+    ShowInsertToSlide = "insertInToSlide",
+    PrimaryNavHidden = "primaryNavHidden",
+    HideProfleAndHelp = "profileAndHelpInNavBarHidden"
 }
 /**
  * The list of actions that can be performed on visual ThoughtSpot
  * entities, such as answers and Liveboards.
+ *
+ * This enum is used to specify the actions that could be disabled,
+ * hidden or made visible.
+ *
+ * @example
+ * ```js
+ * const embed = new LiveboardEmbed('#embed-container', {
+ *    ... // other options
+ *    visibleActions: [Action.Save, Action.Explore],
+ *    disableActions: [Action.Save],
+ *    hiddenActions: [Action.Download], // Set either this or visibleActions
+ * })
+ * ```
  */
 export declare enum Action {
     Save = "save",
@@ -1394,6 +1825,7 @@ export declare enum Action {
     ReplaySearch = "replaySearch",
     ShowUnderlyingData = "showUnderlyingData",
     Download = "download",
+    DownloadAsPng = "downloadAsPng",
     DownloadAsPdf = "downloadAsPdf",
     DownloadAsCsv = "downloadAsCSV",
     DownloadAsXlsx = "downloadAsXLSX",
@@ -1439,12 +1871,18 @@ export declare enum Action {
      * @hidden
      */
     DownloadEmbraceQueries = "downloadEmbraceQueries",
+    /**
+     * Pin action.
+     */
     Pin = "pin",
     /**
      * @hidden
      */
     AnalysisInfo = "analysisInfo",
     Subscription = "subscription",
+    /**
+     * Explore action.
+     */
     Explore = "explore",
     DrillInclude = "context-menu-item-include",
     DrillExclude = "context-menu-item-exclude",
@@ -1456,9 +1894,6 @@ export declare enum Action {
     DrillEdit = "context-menu-item-edit",
     EditMeasure = "context-menu-item-edit-measure",
     Separator = "context-menu-item-separator",
-    /**
-     * @hidden
-     */
     DrillDown = "DRILL",
     RequestAccess = "requestAccess",
     QueryDetailsButtons = "queryDetailsButtons",
@@ -1548,7 +1983,11 @@ export declare enum Action {
     /**
      * @hidden
      */
-    InsertInToSlide = "insertInToSlide"
+    InsertInToSlide = "insertInToSlide",
+    /**
+     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
+     */
+    RenameModalTitleDescription = "renameModalTitleDescription"
 }
 export interface SessionInterface {
     sessionId: string;
@@ -1571,6 +2010,9 @@ export declare enum PrefetchFeatures {
     LiveboardEmbed = "LiveboardEmbed",
     VizEmbed = "VizEmbed"
 }
+/**
+ * Enum for options to change context trigger
+ */
 export declare enum ContextMenuTriggerOptions {
     LEFT_CLICK = "left-click",
     RIGHT_CLICK = "right-click"