/**
 * Copyright (c) 2023
 *
 * TypeScript type definitions for ThoughtSpot Visual Embed SDK
 * @summary Type definitions for Embed SDK
 * @author Ayon Ghosh <ayon.ghosh@thoughtspot.com>
 */

import { CustomCssVariables } from './css-variables';
import type { SessionInterface } from './utils/graphql/answerService/answerService';
// Type-only: avoids a runtime import cycle with the contracts barrel.
import type { Applicability } from './contracts/ui-passthrough-contracts';

/**
 * The authentication mechanism for allowing access to
 * the embedded app
 * @group Authentication / Init
 */

export enum AuthType {
    /**
     * No authentication on the SDK. Pass-through to the embedded App. Alias for
     * `Passthrough`.
     * @example
     * ```js
     * init({
     *   // ...
     *   authType: AuthType.None,
     *  });
     * ```
     */
    None = 'None',
    /**
     * 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.
     * @version SDK: 1.15.0 | ThoughtSpot: 8.8.0.cl
     * @example
     * ```js
     * init({
     *   // ...
     *   authType: AuthType.EmbeddedSSO,
     *  });
     * ```
     */
    EmbeddedSSO = 'EmbeddedSSO',
    /**
     * SSO using SAML, Use {@link SAMLRedirect} instead
     * @deprecated This option is deprecated.
     * @hidden
     */
    SSO = 'SSO_SAML',
    /**
     * SSO using SAML, Use {@link SAMLRedirect} instead
     * @deprecated This option is deprecated.
     * @hidden
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    SAML = 'SSO_SAML',
    /**
     * SSO using SAML
     * 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
     * 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({
     *   // ...
     *   authType: AuthType.SAMLRedirect,
     *   authTriggerText: 'Login with SAML',
     *   authTriggerContainer: '#tsEmbed',
     *   inPopup: true,
     * });
     * ```
     *
     * Can also use the event to trigger the popup flow. Works the same
     * as the above example.
     * @example
     * ```js
     * const authEE = init({
     *  // ...
     *  authType: AuthType.SAMLRedirect,
     *  inPopup: true,
     * });
     *
     * someButtonOnYourPage.addEventListener('click', () => {
     *  authEE.emit(AuthEvent.TRIGGER_SSO_POPUP);
     * });
     * ```
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    SAMLRedirect = 'SSO_SAML',
    /**
     * SSO using OIDC
     * SSO using OIDC, Use {@link OIDCRedirect} instead
     * @deprecated This option is deprecated.
     * @hidden
     */
    OIDC = 'SSO_OIDC',
    /**
     * SSO using OIDC
     * Will make the host application redirect to the OIDC IdP.
     * See code samples in {@link SAMLRedirect}.
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    OIDCRedirect = 'SSO_OIDC',
    /**
     * Trusted authentication server
     * Use {@link TrustedAuth} instead
     * @deprecated This option is deprecated.
     * @hidden
     */
    AuthServer = 'AuthServer',
    /**
     * Trusted authentication server. Use your own authentication server
     * which returns a bearer token, generated using the `secret_key` obtained
     * from ThoughtSpot.
     * @example
     * ```js
     * init({
     *  // ...
     *  authType: AuthType.TrustedAuthToken,
     *  getAuthToken: () => {
     *    return fetch('https://my-backend.app/ts-token')
     *      .then((response) => response.json())
     *      .then((data) => data.token);
     *  }
     * });
     * ```
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    TrustedAuthToken = 'AuthServer',
    /**
     * 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 bypass the third-party cookie-blocking restriction
     * implemented by some browsers.
     * @version SDK: 1.22.0 | ThoughtSpot: 9.3.0.cl, 9.5.1.sw
     * @example
     * ```js
     * init({
     *  // ...
     *  authType: AuthType.TrustedAuthTokenCookieless,
     *  getAuthToken: () => {
     *    return fetch('https://my-backend.app/ts-token')
     *      .then((response) => response.json())
     *      .then((data) => data.token);
     *  }
     * });
     * ```
     */
    TrustedAuthTokenCookieless = 'AuthServerCookieless',
    /**
     * Use the ThoughtSpot login API to authenticate to the cluster directly.
     *
     * Warning: This feature is primarily intended for developer testing. It is
     * strongly advised not to use this authentication method in production.
     */
    Basic = 'Basic',
}
/**
 *
 * **Note**: The classic (V1) and Modular (V2) home page experiences are
 * deprecated. This attribute applies to V3 (ModularWithStylingChanges) and
 * V4 (Focused) home page experiences.
 *
 */

export enum HomeLeftNavItem {
    /**
     * The *Search data* option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
     */
    SearchData = 'search-data',
    /**
     * The *Home* menu option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
     */
    Home = 'insights-home',
    /**
     * The *Liveboards* menu option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
     */
    Liveboards = 'liveboards',
    /**
     * The *Answers* menu option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
     */
    Answers = 'answers',
    /**
     * The *Monitor subscriptions* menu option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
     */
    MonitorSubscription = 'monitor-alerts',
    /**
     * The *SpotIQ analysis* menu option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl
     */
    SpotIQAnalysis = 'spotiq-analysis',
    /**
     * The *Liveboard schedules* menu option in
     * the *Insights* left navigation panel.
     * @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
     */
    LiveboardSchedules = 'liveboard-schedules',
    /**
     * The create option in the *Insights*
     * left navigation panel.
     * Available in the V3 navigation experience.
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    Create = 'create',
    /**
     * The *Spotter* menu option in the *Insights*
     * left navigation panel.
     * Available in the V3 navigation experience.
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    Spotter = 'spotter',
    /**
     * The *Favorites* section in the *Insights*
     * left navigation panel.
     * Available in the V3 navigation experience.
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     */
    Favorites = 'favorites',
    /**
     * The *Collections* menu option in
     * the *Insights* left navigation panel.
     * Shown when collections are enabled on the cluster.
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    Collections = 'collections',
}
export type DOMSelector = string | HTMLElement;

/**
 * inline customCSS within the {@link CustomisationsInterface}.
 * Use {@link CustomCssVariables} or css rules.
 */
export interface customCssInterface {
    /**
     * The custom css variables, which can be set.
     * The variables are available in the {@link CustomCssVariables}
     * interface. For more information, see
     * link:https://developers.thoughtspot.com/docs/css-variables-reference[CSS variable reference].
     */
    variables?: CustomCssVariables;
    /**
     * Can be used to define a custom font face
     * like:
     * @example
     * ```js
     * rules_UNSTABLE?: {
     *     "@font-face": {
     *         "font-family": "custom-font",
     *         "src": url("/path/")
     *     };
     *   };
     * ```
     *
     * Also, custom css rules outside of variables.
     * @example
     * ```js
     * rules_UNSTABLE?: {
     *     ".thoughtspot_class_name": {
     *         "border-radius": "10px",
     *         margin: "20px"
     *     };
     *   };
     * ```
     */

    rules_UNSTABLE?: {
        [selector: string]: {
            [declaration: string]: string;
        };
    };
}
/**
 * Styles within the {@link CustomisationsInterface}.
 */
export interface CustomStyles {
    customCSSUrl?: string;
    customCSS?: customCssInterface;
}

/**
 * Configuration to define the customization on the Embedded
 * ThoughtSpot components.
 * You can customize styles, text strings, and icons.
 * For more information, see link:https://developers.thoughtspot.com/docs/custom-css[CSS customization framework].
 * @example
 * ```js
 *  init({
 *    // ...
 *    customizations: {
 *     style: {
 *       customCSS: {
 *         variables: {},
 *         rules_UNSTABLE: {}
 *       }
 *     },
 *     content: {
 *      strings: {
 *        'LIVEBOARDS': 'Dashboards',
 *        'ANSWERS': 'Visualizations',
 *        'Edit': 'Modify',
 *        'Show underlying data': 'Show source data',
 *        'SpotIQ': 'Insights',
 *        'Monitor': 'Alerts',
 *      }
 *     },
 *     iconSpriteUrl: 'https://my-custom-icon-sprite.svg'
 *    }
 *  })
 * ```
 */
export interface CustomisationsInterface {
    style?: CustomStyles;
    content?: {
        /**
         * @version SDK: 1.26.0 | 9.7.0.cl
         */
        strings?: Record<string, any>;
        stringIDs?: Record<string, string>;
        stringIDsUrl?: string;
        [key: string]: any;
    };
    iconSpriteUrl?: string;
}

/**
 * The configuration object for embedding ThoughtSpot content.
 * It includes the ThoughtSpot hostname or IP address,
 * the type of authentication, and the authentication endpoint
 * if a trusted authentication server is used.
 * @group Authentication / Init
 */
export interface EmbedConfig {
    /**
     * The ThoughtSpot cluster hostname or IP address.
     */
    thoughtSpotHost: string;
    /**
     * 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 API endpoint, which returns the token
     * as a plaintext response. For trusted authentication,
     * the `authEndpoint` or `getAuthToken` attribute is required.
     */
    authEndpoint?: string;
    /**
     * [AuthServer] A function that invokes the trusted authentication endpoint
     * and returns a Promise that resolves to the `auth token` string.
     * For trusted authentication, the `authEndpoint` or `getAuthToken`
     * attribute is required.
     *
     * It is advisable to fetch a new token inside this method and not
     * 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>;
    /**
     * [AuthServer / Basic] The user name of the ThoughtSpot user. This
     * attribute is required for trusted authentication.
     */
    username?: string;

    /**
     * [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.
     */
    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 the browser in
     * place.
     * @deprecated This option is deprecated.
     * @default false
     */
    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 the browser in place.
     *
     * Need to use this with `authTriggerContainer`. Or manually trigger
     * the `AuthEvent.TRIGGER_SSO_POPUP` event on a user interaction.
     * @version SDK: 1.18.0
     * @default false
     */
    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
     * terminated.
     *
     * Eg: "/dashboard", "#/foo" [Do not include the host]
     * @version SDK: 1.10.2 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
     */
    redirectPath?: string;

    /** @internal */
    basepath?: string;

    /**
     * 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
     * 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 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
     * persists even in the case of a non-logged-in user.
     * @default false
     */
    ignoreNoCookieAccess?: boolean;

    /**
     * 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 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 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`
     * @default false
     */
    callPrefetch?: boolean;

    /**
     * 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;

    /**
     * [AuthServer|Basic] Detect if third-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.
     * @version SDK: 1.10.4 | ThoughtSpot: 8.2.0.cl, 8.4.1.sw
     */
    detectCookieAccessSlow?: boolean;
    /**
     * Hide the `beta` alert warning message for SearchEmbed.
     * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw
     */
    suppressSearchEmbedBetaWarning?: boolean;
    /**
     * Custom style params for embed Config.
     * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
     */
    customizations?: CustomisationsInterface;
    /**
     * 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.
     * @version SDK: 1.17.0 | ThoughtSpot: 8.9.0.cl, 9.0.1.sw
     * @example
     * ```js
     * init({
     *   authType: AuthType.SAMLRedirect,
     *   inPopup: true,
     *   authTriggerContainer: '#auth-trigger-container'
     * })
     * ```
     */
    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: 8.9.0.cl, 9.0.1.sw
     */
    authTriggerText?: string;
    /**
     * Prevent embedded application users from accessing ThoughtSpot
     * application pages outside of the iframe.
     * @version SDK: 1.22.0 | ThoughtSpot: 9.3.0.cl, 9.5.1.sw
     * @default true
     */
    blockNonEmbedFullAppAccess?: boolean;

    /**
     * Host config in case embedded app is inside TS app itself
     * @hidden
     */
    hostConfig?: {
        hostUserGuid: string;
        hostClusterId: string;
        hostClusterName: string;
    };

    /**
     * Pendo API key to enable Pendo tracking to your own subscription, the key
     * is added as an additional key to the embed, as per this link:https://support.pendo.io/hc/en-us/articles/360032201951-Send-data-to-multiple-subscriptions[document].
     * @version SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl
     */
    pendoTrackingKey?: string;

    /**
     * If passed as true all alerts will be suppressed in the embedded app.
     * @version SDK: 1.26.2 | ThoughtSpot: *
     */
    suppressErrorAlerts?: boolean;

    /**
     * Suppress or show specific types of logs in the console output.
     * For example, `LogLevel.ERROR` shows only Visual Embed SDK and
     * ThoughtSpot application errors and suppresses
     * other logs such as warnings, information alerts,
     * and debug messages in the console output.
     *
     * @version SDK: 1.26.7 | ThoughtSpot: 9.10.0.cl
     * @default LogLevel.ERROR
     * @example
     * ```js
     * init({
     *   ...embedConfig,
     *   logLevel: LogLevel.SILENT
     * })
     * ```
     */
    logLevel?: LogLevel;
    /**
     * Disables the Mixpanel tracking from the SDK.
     * @version SDK: 1.27.9
     * @hidden
     */
    disableSDKTracking?: boolean;
    /**
     * Overrides default/user preferred locale for date formatting
     * @version SDK: 1.28.4 | ThoughtSpot: 10.0.0.cl, 9.5.0.sw
     */
    dateFormatLocale?: string;
    /**
     * Overrides default/user preferred locale for number formatting
     * @version SDK: 1.28.4 | ThoughtSpot: 10.0.0.cl, 9.5.0.sw
     */
    numberFormatLocale?: string;
    /**
     * Format to be used for currency when currency format is set to infer from browser
     * @version SDK: 1.28.4 | ThoughtSpot: 10.0.0.cl, 9.5.0.sw
     */
    currencyFormat?: string;

    /**
     * This flag is used to disable the token verification in the SDK.
     * Enabling this flag will also disable the caching of the token.
     * @hidden
     * @version SDK: 1.28.5 | ThoughtSpot: 9.10.0.cl, 10.1.0.sw
     * @example
     * ```js
     * init({
     *   ...embedConfig,
     *   disableTokenVerification : true
     * })
     * ```
     */
    disableTokenVerification?: boolean;

    /**
     * This flag is used to disable showing the login failure page in the embedded app.
     * @version SDK: 1.32.3 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
     */
    disableLoginFailurePage?: boolean;
    /**
     * This is an object (key/val) of override flags which will be applied
     * to the internal embedded object. This can be used to add any
     * URL flag.
     * 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.33.5 | ThoughtSpot: *
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#embed', {
     *   ... // other liveboard view config
     *   additionalFlags: {
     *        flag1: 'value1',
     *        flag2: 'value2'
     *     }
     * });
     * ```
     */
    additionalFlags?: { [key: string]: string | number | boolean };
    /**
     * This is an object (key/val) for customVariables being
     * used by the third party tool's script.
     * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#embed', {
     *   ... // other liveboard view config
     *   customVariablesForThirdPartyTools: {
     *        key1: 'value1',
     *        key2: 'value2'
     *     }
     * });
     * ```
     */
    customVariablesForThirdPartyTools?: Record<string, any>;

    disablePreauthCache?: boolean;

    /**
     * Disable fullscreen presentation mode functionality. When enabled, prevents entering
     * and exiting fullscreen mode for embedded visualizations during presentations.
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     * @default true (feature is disabled by default)
     * @example
     * ```js
     * init({
     *   ... // other embed config options
     *   disableFullscreenPresentation: false, // enables the feature
     * })
     * ```
     */
    disableFullscreenPresentation?: boolean;

    /**
     * Custom Actions allows users to define interactive UI actions (like buttons or menu
     * items) that appear in ThoughtSpot's visualizations, answers, and Liveboards. These
     * actions enable users to trigger custom workflows — such as navigating to an
     * external app, calling an API, or opening a modal — based on the data context of
     * what they clicked can be used to trigger custom logic when the action is clicked.
     * @version SDK: 1.43.0 | ThoughtSpot: 10.14.0.cl
     * @example
     * ```js
     * import { CustomActionsPosition, CustomActionTarget } from '@thoughtspot/visual-embed-sdk';
     * init({
     *   ... // other embed config options
     *   customActions: [
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Custom Action',
     *
     *       // Where the action appears in the UI
     *       // PRIMARY: Shows as a primary button (e.g., in the toolbar)
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       // CONTEXTMENU: Shows in the right-click context menu
     *       position: CustomActionsPosition.PRIMARY,
     *
     *       // What type of content this action applies to
     *       // ANSWER: Available on answer pages
     *       target: CustomActionTarget.ANSWER,
     *
     *       // Optional: Restrict where this action appears based on data models
     *       // dataModelIds: {
     *       //     // Restrict to specific data models
     *       //     modelIds: ['model-id-1', 'model-id-2'],
     *       //     // Restrict to specific columns within models
     *       //     modelColumnNames: ['model-id::column-name']
     *       // },
     *
     *       // Optional: Restrict where this action appears based on metadata
     *       // metadataIds: {
     *       //     // Restrict to specific answers
     *       //     answerIds: ['answer-id-1', 'answer-id-2'],
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1', 'group-id-2'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1', 'org-id-2'],
     *     }
     *   ],
     * })
     * ```
     * @example
     * ```js
     * import { CustomActionsPosition, CustomActionTarget } from '@thoughtspot/visual-embed-sdk';
     * init({
     *   ... // other embed config options
     *   customActions: [
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Custom Action',
     *
     *       // Where the action appears in the UI
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       // CONTEXTMENU: Shows in the right-click context menu
     *       position: CustomActionsPosition.MENU,
     *
     *       // What type of content this action applies to
     *       // SPOTTER: Available in Spotter (AI-powered search)
     *       target: CustomActionTarget.SPOTTER,
     *
     *       // Optional: Restrict where this action appears based on data models
     *       // dataModelIds: {
     *       //     // Restrict to specific data models
     *       //     modelIds: ['model-id-1', 'model-id-2'],
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1'],
     *     }
     *   ],
     * })
     * ```
     * @example
     * ```js
     * import { CustomActionsPosition, CustomActionTarget } from '@thoughtspot/visual-embed-sdk';
     * init({
     *   ... // other embed config options
     *   customActions: [
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-liveboard-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Liveboard Custom Action',
     *
     *       // Where the action appears in the UI
     *       // PRIMARY: Shows as a primary button (e.g., in the toolbar)
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       position: CustomActionsPosition.PRIMARY,
     *
     *       // What type of content this action applies to
     *       // LIVEBOARD: Available on liveboard pages
     *       target: CustomActionTarget.LIVEBOARD,
     *
     *       // Optional: Restrict where this action appears based on metadata
     *       // metadataIds: {
     *       //     // Restrict to specific liveboards
     *       //     liveboardIds: ['liveboard-id-1', 'liveboard-id-2'],
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1', 'group-id-2'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1', 'org-id-2'],
     *     },
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-viz-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Viz Custom Action',
     *
     *       // Where the action appears in the UI
     *       // PRIMARY: Shows as a primary button (e.g., in the toolbar)
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       // CONTEXTMENU: Shows in the right-click context menu
     *       position: CustomActionsPosition.PRIMARY,
     *
     *       // What type of content this action applies to
     *       // VIZ: Available on individual visualizations
     *       target: CustomActionTarget.VIZ,
     *
     *       // Optional: Restrict where this action appears based on metadata
     *       // metadataIds: {
     *       //     // Restrict to specific answers
     *       //     answerIds: ['answer-id-1', 'answer-id-2'],
     *       //     // Restrict to specific liveboard. If liveboardId is
     *       //     // passed, custom actions will appear on all vizzes of liveboard
     *       //     liveboardIds: ['liveboard-id-1'],
     *       //     // Restrict to specific vizIds
     *       //     vizIds: ['viz-id-1']
     *       // },
     *       // dataModelIds: {
     *       //     // Restrict to specific data models
     *       //     modelIds: ['model-id-1', 'model-id-2'],
     *       //     // Restrict to specific columns within models
     *       //     modelColumnNames: ['model-id::column-name']
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1', 'group-id-2'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1', 'org-id-2'],
     *     }
     *   ],
     * })
     * ```
     */
    customActions?: CustomAction[];

    /**
     * Wait for the cleanup to be completed before destroying the embed.
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     * @default false
     */
    waitForCleanupOnDestroy?: boolean;
    /**
     * The timeout for the cleanup to be completed before destroying the embed.
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     * @default 5000
     */
    cleanupTimeout?: number;
}

// eslint-disable-next-line @typescript-eslint/no-empty-object-type
export interface LayoutConfig {}

/**
 * Embedded iframe configuration
 * @group Embed components
 */
export interface FrameParams {
    /**
     * The width of the iframe (unit is pixels if numeric).
     */
    width?: number | string;
    /**
     * The height of the iframe (unit is pixels if numeric).
     */
    height?: number | string;
    /**
     * Set to 'lazy' to enable lazy loading of the embedded TS frame.
     * This will defer loading of the frame until it comes into the
     * viewport. This is useful for performance optimization.
     */
    loading?: 'lazy' | 'eager' | 'auto';
    /**
     * These parameters will be passed to the iframe
     * as is.
     */
    [key: string]: string | number | boolean | undefined;
}

/**
 * Configuration for the pre-render wrapper element.
 * Each property here supersedes its deprecated top-level counterpart on
 * {@link BaseViewConfig} — `id` over `preRenderId`, `containerSelector` over
 * `preRenderContainer` and `doNotTrackSize` over `doNotTrackPreRenderSize` —
 * and takes precedence when both are set, so existing top-level usage continues
 * to work without any changes.
 *
 * @version SDK: 1.52.0
 * @example
 * ```js
 * init({ thoughtSpotHost: '...', authType: AuthType.None });
 * const embed = new LiveboardEmbed('#tsEmbed', {
 *   preRenderConfig: {
 *     id: 'my-liveboard',
 *     containerSelector: '#my-scroll-container',
 *     doNotTrackSize: false,
 *     zIndex: -10,
 *   },
 * });
 * embed.preRender();
 * embed.showPreRender();
 * ```
 */
export interface PreRenderConfig {
    /**
     * Pre-render ID to identify the pre-render instance.
     * Takes precedence over the top-level `preRenderId` when both are set.
     *
     * Matches the embed warmed by `preRender()` to the one revealed by
     * `showPreRender()`. Embeds sharing an ID share one loaded frame: reuse the ID for
     * the same view, and give unrelated views their own or they will collide.
     * Required by `preRender()`, `showPreRender()`, and `hidePreRender()`, which log
     * and do nothing without it.
     *
     * @default undefined
     */
    id?: string;
    /**
     * The DOM element or CSS selector string specifying the container into
     * which the pre-rendered wrapper is inserted.
     * Takes precedence over the top-level `preRenderContainer` when both are set.
     *
     * Set this when your app scrolls inside an element rather than the page (for
     * example `<body>` has `overflow: hidden`). Point it at the element that actually
     * scrolls, keep that element mounted while the embed is warm, and prefer a
     * selector string — it is re-resolved on reposition and so survives a remount,
     * while a detached element reference cannot be recovered. An invalid selector is
     * logged and falls back to `document.body`.
     * See {@link BaseViewConfig.preRenderContainer} for details, including Shadow DOM.
     *
     * @default document.body
     */
    containerSelector?: string | HTMLElement;
    /**
     * Disables the `ResizeObserver` that keeps the wrapper sized to the
     * placeholder element.
     * Takes precedence over the top-level `doNotTrackPreRenderSize` when both are set.
     *
     * Set this only when you size the embed yourself; you then own alignment and must
     * call `syncPreRenderStyle()` after any change that moves or resizes it. Tracking
     * already pauses while hidden, so this is not needed to avoid work then.
     *
     * @default false
     */
    doNotTrackSize?: boolean;
    /**
     * CSS `z-index` value applied to the pre-render wrapper when hidden.
     * Override this when the host page's stacking context does not reach `-1000`
     * and the hidden wrapper still appears above other elements.
     *
     * A page that creates its own stacking context — a positioned app shell, a
     * transformed wrapper, a modal layer — can clamp `-1000`, and the hidden wrapper
     * then shows through or swallows clicks meant for your UI. Reach for this when you
     * see a faint panel behind your content, or clicks landing on nothing in the
     * region where the embed will eventually appear.
     *
     * @default -1000
     */
    zIndex?: number;
}

/**
 * The common configuration object for an embedded view.
 */
export interface BaseViewConfig extends ApiInterceptFlags {
    /**
     * @hidden
     */
    layoutConfig?: LayoutConfig;
    /**
     * The width and height dimensions to render an embedded
     * object inside your app.  Specify the values in pixels or percentage.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    frameParams: {
     *        width: '500px' | '50%',
     *        height: '400px' | '60%',
     *    },
     * })
     * ```
     */
    frameParams?: FrameParams;
    /**
     * @hidden
     */
    theme?: string;
    /**
     * @hidden
     */

    styleSheet__unstable?: string;
    /**
     * The list of actions to disable from the primary menu, more menu
     * (...), and the contextual menu. Disabled actions are grayed out
     * and still visible to the user, but cannot be clicked.
     * Use this when you want to disable an action (keep it visible but non-interactive).
     * To completely remove an action from the UI, use {@link hiddenActions} instead.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    disabledActions: [Action.Download, Action.Save],
     * });
     * ```
     */
    disabledActions?: Action[];
    /**
     * The tooltip to display for disabled actions.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    disabledActions: [Action.Download, Action.Save],
     *    disabledActionReason: "Reason for disabling",
     * });
     * ```
     */
    disabledActionReason?: string;
    /**
     * The list of actions to completely remove from the embedded view.
     * Hidden actions are not visible to the user at all (fully removed from the UI).
     * Use this when you want to remove an action entirely.
     * To keep an action visible but non-interactive (grayed out), use {@link
     * disabledActions} instead.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    hiddenActions: [Action.Download, Action.ExportTML],
     * });
     * ```
     * @important
     */
    hiddenActions?: Action[];
    /**
     * The list of actions to display from the primary menu, more menu
     * (...), and the contextual menu. These will be only actions that
     * are visible to the user.
     * Use this as an allowlist — only the actions listed here will be shown.
     * All other actions will be hidden. Use either this or {@link hiddenActions}, not
     * both.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
     * @important
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    visibleActions: [Action.Download, Action.ExportTML],
     * });
     * ```
     */
    visibleActions?: Action[];
    /**
     * The locale settings to apply to the embedded view.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.9.4 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    locale:'en',
     * })
     * ```
     */
    locale?: string;
    /**
     * This is an object (key/val) of override flags which will be applied
     * to the internal embedded object. This can be used to add any
     * URL flag.
     * If the same flags are passed in init, they will be overridden by the values here.
     * 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.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *   additionalFlags: {
     *        flag1: 'value1',
     *        flag2: 'value2'
     *     },
     * });
     * ```
     */
    additionalFlags?: { [key: string]: string | number | boolean };
    /**
     * 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.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.2.0 | ThoughtSpot: 9.0.0.cl, 9.0.0.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    insertAsSibling:true,
     * })
     * ```
     */
    insertAsSibling?: 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;
    /**
     * PreRender id to be used for PreRendering the embed.
     * Use PreRender to render the embed in the background and then
     * show or hide the rendered embed using showPreRender or hidePreRender respectively.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.25.0 | ThoughtSpot: 9.6.0.cl, 9.8.0.sw
     * @deprecated Use {@link PreRenderConfig.id} via `preRenderConfig` instead.
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *   preRenderId: "preRenderId-123",
     * });
     * embed.showPreRender();
     * ```
     */
    preRenderId?: string;

    /**
     * Determines if the PreRender component should dynamically track the size
     * of its embedding element and adjust its own size accordingly.
     * Enabling this option allows the PreRender component to automatically adapt
     * its dimensions based on changes to the size of the embedding element.
     * @type {boolean}
     * @default false
     * @version SDK: 1.24.0 | ThoughtSpot: 9.4.0.cl, 9.4.0.sw
     * @deprecated Use {@link PreRenderConfig.doNotTrackSize} via `preRenderConfig` instead.
     * @example
     * ```js
     * // Disable tracking PreRender size in the configuration
     * const config = {
     *   doNotTrackPreRenderSize: true,
     * };
     *
     * // Instantiate an object with the configuration
     * const myComponent = new MyComponent(config);
     * ```
     */
    doNotTrackPreRenderSize?: boolean;
    /**
     * The DOM element or CSS selector string specifying the container into which
     * the pre-rendered wrapper is inserted. Defaults to `document.body` when not
     * specified.
     *
     * **When to use a target container:** set this when the pre-render should
     * live somewhere other than `document.body` — for example when `<body>` has
     * `overflow: hidden` and scrolling is handled by an inner element, or when
     * you need the wrapper to sit inside a specific stacking/positioning context.
     * The wrapper is positioned to track the embedding element within this
     * container, so choose the scrollable/positioned ancestor you want it
     * aligned to.
     *
     * **Pass a stable container:** the wrapper is mounted into the resolved
     * container once, during `preRender()`. The container must stay mounted for
     * the lifetime of the pre-render — if the host app unmounts and remounts it
     * (for example React replacing the node), the wrapper is orphaned on the
     * detached node. Mount the container above the part of the tree that
     * re-renders so its identity is stable. Prefer a CSS selector string over a
     * raw element: a selector can be re-resolved to the fresh node on the next
     * reposition, whereas an element reference cannot be recovered once detached.
     *
     * When the embed host lives inside a Shadow DOM, a selector string is
     * resolved against that shadow root as well (since `document.querySelector`
     * cannot pierce shadow boundaries); pass the element directly if the
     * container lives in a different root.
     *
     * @type {string | HTMLElement}
     * @version SDK: 1.49.2 | ThoughtSpot: *
     * @deprecated Use {@link PreRenderConfig.containerSelector} via `preRenderConfig` instead.
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *   preRenderId: 'my-liveboard',
     *   // Prefer a selector for a stable, scrollable container.
     *   preRenderContainer: '#my-scroll-container',
     * });
     * ```
     */
    preRenderContainer?: string | HTMLElement;
    /**
     * Configuration for the pre-render wrapper element.
     * Each property here supersedes its deprecated top-level counterpart on
     * `BaseViewConfig` — `id` over `preRenderId`, `containerSelector` over
     * `preRenderContainer` and `doNotTrackSize` over `doNotTrackPreRenderSize` —
     * and takes precedence when both are set, so existing top-level usage
     * continues to work without any changes.
     * See {@link PreRenderConfig} for available options.
     *
     * @version SDK: 1.52.0
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *   preRenderConfig: {
     *     id: 'my-liveboard',
     *     zIndex: -10,
     *   },
     * });
     * embed.preRender();
     * embed.showPreRender();
     * ```
     */
    preRenderConfig?: PreRenderConfig;
    /**
     * Enable the V2 shell. This can provide performance benefits
     * due to a lighter-weight shell.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.31.2 | ThoughtSpot: 10.0.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *   enableV2Shell_experimental: true,
     * });
     * ```
     */

    enableV2Shell_experimental?: boolean;
    /**
     * For internal tracking of the embed component type.
     * @hidden
     */
    embedComponentType?: string;
    /**
     * This flag can be used to expose translation IDs on the embedded app.
     * @default false
     * @version SDK: 1.37.0 | ThoughtSpot: 10.9.0.cl
     */
    exposeTranslationIDs?: boolean;
    /**
     * This flag can be used to disable links inside the embedded app,
     * and disable redirection of links in a new tab.
     *
     * Note: When set to `true`, this flag automatically disables
     * {@link enableLinkOverridesV2} for the
     * embed session. The two features are mutually exclusive — link
     * overrides mutate anchors (delete `href`, attach a JS click handler),
     * which breaks native browser behavior (Cmd/Ctrl+Click, middle-click,
     * right-click "Open in new tab") when combined with the disable flag.
     * The disable flag preserves native anchor semantics instead.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.32.1 | ThoughtSpot: 10.3.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *   ... // other embed view config
     *   disableRedirectionLinksInNewTab: true,
     * });
     * ```
     */
    disableRedirectionLinksInNewTab?: boolean;
    /**
     * Overrides an Org context for embedding application users.
     * This parameter allows a user authenticated to one Org to view the
     * objects from another Org.
     * The `overrideOrgId` setting is honoured only if the
     * Per Org URL feature is enabled on your ThoughtSpot instance.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.35.0 | ThoughtSpot: 10.5.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *   ... // other embed view config
     *   overrideOrgId: 142536,
     * });
     * ```
     */
    overrideOrgId?: number;
    /**
     * Overrides the browser history behavior for embedding application users.
     * This parameter changes standard history navigation (pushState) into a
     * state replacement (replaceState), preventing users from getting trapped in
     * back-button loops inside the embedded iframe environment.
     * The overrideHistoryState setting is honored only if the
     * application is running within an embedded context.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterAgentEmbed`, `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *     // ... other embed view config
     *     overrideHistoryState: true,
     * });
     * ```
     */
    overrideHistoryState?: boolean;
    /**
     * Flag to override the *Open Link in New Tab* context
     * menu option.
     *
     * Note: Setting this flag implicitly enables
     * {@link enableLinkOverridesV2}. V1 is auto-upgraded to
     * V2 to ensure consistent link-override behavior; the
     * legacy V1-only path is no longer used in isolation.
     *
     * Note: This flag is ignored when
     * {@link disableRedirectionLinksInNewTab} is `true`.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
     * `SearchEmbed`, `SpotterAgentEmbed`,
     * `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *    ... // other embed view config
     *    linkOverride: true,
     * })
     * ```
     */
    linkOverride?: boolean;
    /**
     * Enables the V2 link override mechanism with improved
     * handling. When enabled, navigation links within the
     * embedded ThoughtSpot app are intercepted and routed
     * through the SDK via the `EmbedEvent.DialogOpen`
     * event.
     *
     * The SDK automatically sends {@link linkOverride}
     * alongside this flag for backward compatibility with
     * older ThoughtSpot versions.
     *
     * Note: This flag is ignored when
     * {@link disableRedirectionLinksInNewTab} is `true`.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`,
     * `SearchEmbed`, `SpotterAgentEmbed`,
     * `SpotterEmbed`, `SearchBarEmbed`
     * @version SDK: 1.46.0 | ThoughtSpot: 26.2.0.cl
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *    ... // other embed view config
     *    enableLinkOverridesV2: true,
     * });
     *
     * embed.on(EmbedEvent.DialogOpen, (payload) => {
     *    console.log('Link clicked:', payload);
     * });
     * ```
     */
    enableLinkOverridesV2?: boolean;
    /**
     * The primary action to display on top of the viz for Liveboard and App Embed.
     * Use this to set the primary action.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.39.0 | ThoughtSpot: 10.11.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *   primaryAction: Action.Download
     * });
     * ```
     */
    primaryAction?: Action | string;
    /**
     * flag to enable insert into slides action
     * @hidden
     * @private
     */
    insertInToSlide?: boolean;
    /**
     * Show alert messages and toast messages in the embed.
     * Supported in all embed types.
     *
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * const embed = new AppEmbed('#tsEmbed', {
     *    ... // other embed view config
     *    showAlerts:true,
     * })
     * ```
     */
    showAlerts?: boolean;
    /**
     * Custom Actions allows users to define interactive UI actions (like buttons or menu
     * items) that appear in ThoughtSpot's visualizations, answers, and Liveboards. These
     * actions enable users to trigger custom workflows — such as navigating to an
     * external app, calling an API, or opening a modal — based on the data context of
     * what they clicked can be used to trigger custom logic when the action is clicked.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`, `SpotterEmbed`
     * @version SDK: 1.43.0 | ThoughtSpot: 10.14.0.cl
     * @example
     * ```ts
     * import {
     *   CustomActionPayload,
     *   CustomActionsPosition,
     *   CustomActionTarget,
     * } from '@thoughtspot/visual-embed-sdk';
     * // Use supported embed types such as AppEmbed or LiveboardEmbed
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *   ... // other embed config options
     *   customActions: [
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Custom Action',
     *
     *       // Where the action appears in the UI
     *       // PRIMARY: Shows as a primary button (e.g., in the toolbar)
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       // CONTEXTMENU: Shows in the right-click context menu
     *       position: CustomActionsPosition.PRIMARY,
     *
     *       // What type of content this action applies to
     *       // ANSWER: Available on answer pages
     *       target: CustomActionTarget.ANSWER,
     *
     *       // Optional: Restrict where this action appears based on data models
     *       // dataModelIds: {
     *       //     // Restrict to specific data models
     *       //     modelIds: ['model-id-1', 'model-id-2'],
     *       //     // Restrict to specific columns within models
     *       //     modelColumnNames: ['model-id::column-name']
     *       // },
     *
     *       // Optional: Restrict where this action appears based on metadata
     *       // metadataIds: {
     *       //     // Restrict to specific answers
     *       //     answerIds: ['answer-id-1', 'answer-id-2'],
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1', 'group-id-2'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1', 'org-id-2'],
     *     }
     *   ],
     * })
     *
     * // to trigger a custom flow on custom action click listen to Custom action embed event
     * embed.on(EmbedEvent.CustomAction, (payload: CustomActionPayload) => {
     *   console.log('Custom Action event:', payload);
     * })
     * ```
     * @example
     * ```ts
     * import {
     *   CustomActionsPosition,
     *   CustomActionTarget,
     * } from '@thoughtspot/visual-embed-sdk';
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *   ... // other embed config options
     *   customActions: [
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Custom Action',
     *
     *       // Where the action appears in the UI
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       // CONTEXTMENU: Shows in the right-click context menu
     *       position: CustomActionsPosition.MENU,
     *
     *       // What type of content this action applies to
     *       // SPOTTER: Available in Spotter (AI-powered search)
     *       target: CustomActionTarget.SPOTTER,
     *
     *       // Optional: Restrict where this action appears based on data models
     *       // dataModelIds: {
     *       //     // Restrict to specific data models
     *       //     modelIds: ['model-id-1', 'model-id-2'],
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1'],
     *     }
     *   ],
     * })
     * ```
     * @example
     * ```ts
     * import {
     *   CustomActionsPosition,
     *   CustomActionTarget,
     * } from '@thoughtspot/visual-embed-sdk';
     * const embed = new LiveboardEmbed('#tsEmbed', {
     *   ... // other embed config options
     *   customActions: [
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-liveboard-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Liveboard Custom Action',
     *
     *       // Where the action appears in the UI
     *       // PRIMARY: Shows as a primary button (e.g., in the toolbar)
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       position: CustomActionsPosition.PRIMARY,
     *
     *       // What type of content this action applies to
     *       // LIVEBOARD: Available on liveboard pages
     *       target: CustomActionTarget.LIVEBOARD,
     *
     *       // Optional: Restrict where this action appears based on metadata
     *       // metadataIds: {
     *       //     // Restrict to specific liveboards
     *       //     liveboardIds: ['liveboard-id-1', 'liveboard-id-2'],
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1', 'group-id-2'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1', 'org-id-2'],
     *     },
     *     {
     *       // Unique identifier for the custom action
     *       id: 'my-viz-custom-action',
     *
     *       // Display name shown to users in the UI
     *       name: 'My Viz Custom Action',
     *
     *       // Where the action appears in the UI
     *       // PRIMARY: Shows as a primary button (e.g., in the toolbar)
     *       // MENU: Shows in the "More" menu (three dots menu)
     *       // CONTEXTMENU: Shows in the right-click context menu
     *       position: CustomActionsPosition.PRIMARY,
     *
     *       // What type of content this action applies to
     *       // VIZ: Available on individual visualizations
     *       target: CustomActionTarget.VIZ,
     *
     *       // Optional: Restrict where this action appears based on metadata
     *       // metadataIds: {
     *       //     // Restrict to specific answers
     *       //     answerIds: ['answer-id-1', 'answer-id-2'],
     *       //     // Restrict to specific liveboard. If liveboardId is
     *       //     // passed, custom actions will appear on all vizzes of liveboard
     *       //     liveboardIds: ['liveboard-id-1'],
     *       //     // Restrict to specific vizIds
     *       //     vizIds: ['viz-id-1']
     *       // },
     *       // dataModelIds: {
     *       //     // Restrict to specific data models
     *       //     modelIds: ['model-id-1', 'model-id-2'],
     *       //     // Restrict to specific columns within models
     *       //     modelColumnNames: ['model-id::column-name']
     *       // },
     *       //     // Restrict to specific groups (for group-based access control)
     *       //     groupIds: ['group-id-1', 'group-id-2'],
     *       //     // Restrict to specific organizations (for multi-org deployments)
     *       //     orgIds: ['org-id-1', 'org-id-2'],
     *     }
     *   ],
     * })
     * ```
     */
    customActions?: CustomAction[];

    /**
     * Refresh the auth token when the token is near expiry.
     * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
     * @default true
     * @example
     * ```js
     * const embed = new AppEmbed('#tsEmbed', {
     *    ... // other embed view config
     *    refreshAuthTokenOnNearExpiry: true,
     * })
     * ```
     */
    refreshAuthTokenOnNearExpiry?: boolean;
    /**
     * This flag skips payload validation so events can be processed even if the payload is old, incomplete, or from a trusted system.
     * @default false
     * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
     * @example
     * ```js
     * const embed = new AppEmbed('#tsEmbed', {
     *    ... // other embed view config
     *    shouldBypassPayloadValidation:true,
     * })
     * ```
     */
    shouldBypassPayloadValidation?: boolean;

    /**
     * Flag to use host events v2. This is used to enable the new host events v2 API.
     * @default false
     * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
     * @example
     * ```js
     * const embed = new AppEmbed('#tsEmbed', {
     *    ... // other embed view config
     *    useHostEventsV2:true,
     * })
     * ```
     */
    useHostEventsV2?: boolean;
}

/**
 * Configuration for {@link startAutoMCPFrameRenderer}.
 *
 * Extends {@link BaseViewConfig} but omits params that are not applicable
 * to the auto-frame renderer:
 * - `preRenderId` / `usePrerenderedIfAvailable` / `doNotTrackPreRenderSize` —
 *   the renderer always replaces a live iframe in-place; prerender pools are not used.
 * - `insertAsSibling` — insertion is always a same-position `replaceWith`; the
 *   container-append path is never taken.
 * - `primaryAction` — a Liveboard/AppEmbed-specific feature; the renderer renders
 *   whatever route the MCP server specifies.
 * - `enableV2Shell_experimental` — the renderer always uses the v2 URL format;
 *   this flag has no effect.
 */
export type AutoMCPFrameRendererViewConfig = Omit<
    BaseViewConfig,
    | 'preRenderId'
    | 'usePrerenderedIfAvailable'
    | 'doNotTrackPreRenderSize'
    | 'insertAsSibling'
    | 'primaryAction'
    | 'enableV2Shell_experimental'
>;

/**
 * The configuration object for Home page embeds configs.
 */
export interface HomePageConfig {
    /**
     * Hide columns on list pages such as
     * *Liveboards* and *Answers*.
     * For example: `hiddenListColumns = [ListPageColumns.Author]`
     *
     * **Note**: This option is available only in full app embedding and requires
     * importing the `ListPageColumns` enum. Starting with version 10.14.0.cl, you can
     * use this attribute to
     * hide the columns on all list pages in the *Insights* section.
     *
     * Supported embed types: `AppEmbed`
     * @version SDK: 1.38.0 | ThoughtSpot: 10.9.0.cl
     * @example
     * ```js
     * import { ListPageColumns } from '@thoughtspot/visual-embed-sdk';
     *
     * const embed = new AppEmbed('#tsEmbed', {
     *    ... //other embed view config
     *    hiddenListColumns : [ListPageColumns.Favorites,ListPageColumns.Author],
     * })
     * ```
     */
    hiddenListColumns?: ListPageColumns[];
    /**
     * Control the visibility of home page modules.
     * To specify the modules, import the `HomepageModule` enum.
     * For example: `hiddenHomepageModules = [HomepageModule.MyLibrary]`
     *
     * **Note**: The classic (V1) and Modular (V2) home page experiences are
     * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
     * and V4 (Focused) home page experiences.
     *
     * Supported embed types: `AppEmbed`
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
     * @example
     * ```js
     * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
     *
     * const embed = new AppEmbed('#tsEmbed', {
     *    ... // V3 navigation and home page experience attributes
     *    hiddenHomepageModules : [HomepageModule.Favorite,HomepageModule.Learning],
     *    //...other embed view configuration attributes
     * })
     * ```
     */
    hiddenHomepageModules?: HomepageModule[];
    /**
     * Reorder home page modules.
     * To specify the modules, import the `HomepageModule` enum.
     * For example: `reorderedHomepageModules = [HomepageModule.MyLibrary,
     * HomepageModule.Watchlist]`
     *
     * **Note**: The classic (V1) and Modular (V2) home page experiences are
     * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
     * and V4 (Focused) home page experiences.
     *
     * Supported embed types: `AppEmbed`
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
     * @example
     * ```js
     * import { HomepageModule } from '@thoughtspot/visual-embed-sdk';
     *
     * const embed = new AppEmbed('#tsEmbed', {
     *    ...//V3 navigation and home page experience attributes
     *    reorderedHomepageModules:[HomepageModule.Favorite,HomepageModule.MyLibrary],
     *    //... other embed view configuration attributes
     * })
     * ```
     */
    reorderedHomepageModules?: HomepageModule[];
    /**
     * Controls the visibility of the menu items
     * on the home page left navigation panel.
     * To specify the menu items, import the `HomeLeftNavItem` enum.
     *
     * **Note**: The classic (V1) and Modular (V2) home page experiences are
     * deprecated. This attribute applies to V3 (ModularWithStylingChanges)
     * and V4 (Focused) home page experiences.
     *
     * Supported embed types: `AppEmbed`
     * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
     * @example
     * ```js
     * import { HomeLeftNavItem } from '@thoughtspot/visual-embed-sdk';
     *
     * const embed = new AppEmbed('#tsEmbed', {
     *    //... V2/V3 experience attributes
     *    hiddenHomeLeftNavItems : [HomeLeftNavItem.Home,HomeLeftNavItem.Answers],
     *    ... //other embed view configuration attributes
     * })
     * ```
     */
    hiddenHomeLeftNavItems?: HomeLeftNavItem[];
}

/**
 * The configuration object for common Search and Liveboard embeds configs.
 */
export interface SearchLiveboardCommonViewConfig {
    /**
     * The list of runtime filters to apply to a search Answer,
     * visualization, or Liveboard.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`
     * @version SDK: 1.9.4 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    runtimeFilters: [
     *           {
     *             columnName: 'value',
     *              operator: RuntimeFilterOp.EQ,
     *             values: ['string' | 123 | true],
     *           },
     *       ],
     * })
     * ```
     */
    runtimeFilters?: RuntimeFilter[];
    /**
     * The list of parameter overrides to apply to a search Answer,
     * visualization, or Liveboard.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`, `SearchEmbed`
     * @version SDK: 1.25.0 | ThoughtSpot: 9.2.0.cl, 9.5.0.sw
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SearchEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    runtimeParameters: [
     *     {
     *       name: 'value',
     *       value: 'string' | 123 | true,
     *     },
     *   ]
     * })
     * ```
     */
    runtimeParameters?: RuntimeParameter[];
    /**
     * flag to set ContextMenu Trigger to either left or right click.
     *
     * Supported embed types: `AppEmbed`, `SearchEmbed`
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    contextMenuTrigger:ContextMenuTriggerOptions.LEFT_CLICK || RIGHT_CLICK,
     * })
     * ```
     */
    contextMenuTrigger?: ContextMenuTriggerOptions;
    /**
     * Boolean to exclude runtimeFilters in the URL
     * By default it is true, this flag removes runtime filters from the URL
     * (default behavior from SDK 1.45.0).
     * when set to false, runtime filters will be included in the URL
     * (default behavior before SDK 1.45.0).
     *
     * Irrespective of this flag, runtime filters ( if passed ) will be applied to the
     * embedded view.
     * @default true
     * @version SDK: 1.24.0 | ThoughtSpot: 9.5.0.cl
     */
    excludeRuntimeFiltersfromURL?: boolean;
    /**
     * Boolean to exclude runtimeParameters from the URL
     * when set to true, this flag removes runtime parameters from the URL
     * (default behavior from SDK 1.45.0).
     * when set to false, runtime parameters will be included in the URL
     * (default behavior before SDK 1.45.0).
     *
     * Irrespective of this flag, runtime parameters (if passed) will be applied to the
     * embedded view.
     * @default true
     * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl
     */
    excludeRuntimeParametersfromURL?: boolean;
    /**
     * To set the initial state of the search bar in case of saved Answers.
     *
     * Supported embed types: `AppEmbed`, `SearchBarEmbed`
     * @default true
     * @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchBarEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *   collapseSearchBar: true,
     * });
     * ```
     */
    collapseSearchBar?: boolean;
    /**
     * Flag to control Data panel experience
     *
     * Supported embed types: `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
     * @deprecated from SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     * @default true
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, or SearchBarEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    dataPanelV2: true,
     * })
     * ```
     */
    dataPanelV2?: boolean;
    /**
     * To enable custom column groups in data panel v2
     *
     * Supported embed types: `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, SearchBarEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *   ... // other embed view config
     *   enableCustomColumnGroups: true,
     * });
     * ```
     */
    enableCustomColumnGroups?: boolean;
    /**
     * To enable **Include current period** checkbox for date filters.
     * Controls the visibility of the option to include
     * the current time period in filter results.
     *
     * Supported embed types: `AppEmbed`, `SearchBarEmbed`, `LiveboardEmbed`, `SearchEmbed`
     * @version SDK: 1.45.0 | ThoughtSpot: 26.4.0.cl
     * @example
     * ```js
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isThisPeriodInDateFiltersEnabled: true,
     * })
     * ```
     */
    isThisPeriodInDateFiltersEnabled?: boolean;
}

/**
 * The configuration object for common Liveboard and App embeds configs.
 */
export interface LiveboardAppEmbedViewConfig {
    /**
     * Show or hide Liveboard header
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    hideLiveboardHeader : true,
     * })
     * ```
     */
    hideLiveboardHeader?: boolean;
    /**
     * Show or hide Liveboard title
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    showLiveboardTitle:true,
     * })
     * ```
     */
    showLiveboardTitle?: boolean;
    /**
     * Show or hide Liveboard description
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    showLiveboardDescription:true,
     * })
     * ```
     */
    showLiveboardDescription?: boolean;
    /**
     * Boolean to control if Liveboard header is sticky or not.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#embed', {
     *   ... // other app view config
     *   isLiveboardHeaderSticky: true,
     * });
     * ```
     */
    isLiveboardHeaderSticky?: boolean;
    /**
     * This attribute can be used to enable the two-column layout on an embedded Liveboard
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @type {boolean}
     * @version SDK: 1.32.0 | ThoughtSpot: 10.1.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    enable2ColumnLayout: true,
     * })
     * ```
     */
    enable2ColumnLayout?: boolean;
    /**
     * This attribute keeps an embedded Liveboard on the 12-column layout at
     * every width, instead of switching to the two-column or single-column
     * layout as the container narrows.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @type {boolean}
     * @version SDK: 1.51.1 | ThoughtSpot Cloud: 26.8.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isLiveboardAlwaysOn12ColLayout: true,
     * })
     * ```
     */
    isLiveboardAlwaysOn12ColLayout?: boolean;
    /**
     * This flag can be used to enable the compact header in Liveboard
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @type {boolean}
     * @version SDK: 1.35.0 | ThoughtSpot: 10.3.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isLiveboardCompactHeaderEnabled: true,
     * })
     * ```
     */
    isLiveboardCompactHeaderEnabled?: boolean;
    /**
     * This flag can be used to show or hide the Liveboard verified icon in the compact
     * header.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.35.0 | ThoughtSpot: 10.4.0.cl
     * @default true
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    showLiveboardVerifiedBadge: true,
     * })
     * ```
     */
    showLiveboardVerifiedBadge?: boolean;
    /**
     * This flag is used to enable/disable hide irrelevant filters in Liveboard tab
     *
     * **Note**: This feature is supported only if compact header is enabled on your
     * Liveboard. To enable compact header, use the `isLiveboardCompactHeaderEnabled`
     * attribute.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    hideIrrelevantChipsInLiveboardTabs: true,
     *    isLiveboardCompactHeaderEnabled: true,
     * })
     * ```
     */
    hideIrrelevantChipsInLiveboardTabs?: boolean;
    /**
     * This flag can be used to show or hide the re-verify banner on the Liveboard
     * compact header
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.35.0 | ThoughtSpot: 10.4.0.cl
     * @default true
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    showLiveboardReverifyBanner: true,
     * })
     * ```
     */
    showLiveboardReverifyBanner?: boolean;
    /**
     * enable or disable ask sage
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.29.0 | ThoughtSpot: 9.12.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed, SpotterEmbed, or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    enableAskSage:true,
     * })
     * ```
     */
    enableAskSage?: boolean;
    /**
     * This flag is used to show or hide checkboxes for including or excluding
     * the cover and filters pages in the Liveboard PDF.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.40.0 | ThoughtSpot: 10.8.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    coverAndFilterOptionInPDF: false,
     * })
     * ```
     */
    coverAndFilterOptionInPDF?: boolean;
    /**
     * Sets the gutter space (in pixels) between the visualization tiles of
     * an embedded Liveboard grid layout and its outer layout padding.
     * Accepts a non-negative integer; `0` renders the tiles without any gap
     * and removes the outer padding. When omitted, the gutter saved in the
     * Liveboard's styling settings (or the ThoughtSpot default) applies.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @type {number}
     * @version SDK: 1.51.1 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    liveboardGutter: 8,
     * })
     * ```
     */
    liveboardGutter?: number;
    /**
     * This flag is used to enable or disable the new centralized Liveboard filter UX
     * (v2). When enabled, a unified modal is used to manage and update multiple filters
     * at once, replacing the older individual filter interactions.
     * To enable this feature on your instance, contact ThoughtSpot Support.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.46.0 | ThoughtSpot: 26.4.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isCentralizedLiveboardFilterUXEnabled: true,
     * })
     * ```
     */
    isCentralizedLiveboardFilterUXEnabled?: boolean;
    /**
     * This flag is used to enable or disable scoped Liveboard filtering.
     * When enabled, filters and parameters can be scoped to a group of
     * visualizations on a Liveboard, in addition to the Liveboard and
     * tab levels.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isScopedLiveboardFilteringEnabled: true,
     * })
     * ```
     */
    isScopedLiveboardFilteringEnabled?: boolean;
    /**
     * This flag is used to enable or disable the link parameters in liveboard.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.42.0 | ThoughtSpot: 10.14.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isLinkParametersEnabled: true,
     * })
     * ```
     */
    isLinkParametersEnabled?: boolean;

    /**
     * This flag is used to enable or disable the enhanced filter interactivity in
     * liveboard.
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.42.0 | ThoughtSpot: 10.15.0.cl
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isEnhancedFilterInteractivityEnabled: true,
     * })
     * ```
     */
    isEnhancedFilterInteractivityEnabled?: boolean;
    /**
     * Show or hide masked filter chips
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    showMaskedFilterChip: true,
     * })
     * ```
     */
    showMaskedFilterChip?: boolean;
    /**
     * Enable or disable Liveboard styling and grouping
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    isLiveboardMasterpiecesEnabled: true,
     * })
     * ```
     */
    isLiveboardMasterpiecesEnabled?: boolean;
    /**
     * Enable or disable Muze chart phase 1 GA
     *
     * Supported embed types: `AppEmbed`, `LiveboardEmbed`
     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
     * @default false
     * @example
     * ```js
     * // Replace <EmbedComponent> with embed component name. For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#tsEmbed', {
     *    ... // other embed view config
     *    newChartsLibrary: true,
     * })
     * ```
     */
    newChartsLibrary?: boolean;
}

export interface AllEmbedViewConfig
    extends BaseViewConfig,
        SearchLiveboardCommonViewConfig,
        HomePageConfig,
        LiveboardAppEmbedViewConfig {}

/**
 * MessagePayload: Embed event payload: message type, data and status (start/end)
 * @group Events
 */
export type MessagePayload = {
    /* type: message type eg: 'save' */
    type: string;
    /* data: message payload data eg: { answerId: '123' } */
    data: any;
    /* status: message payload status - start or end */
    status?: string;
};
/**
 * 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: Message payload contains type, data, and status */
    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
     */
    /* callback: Embed event message callback */
    options: MessageOptions;
    callback: MessageCallback;
};

export type GenericCallbackFn = (...args: any[]) => any;

export type QueryParams = {
    [key: string]: string | boolean | number;
};

/**
 * A map of the supported runtime filter operations
 */

export enum RuntimeFilterOp {
    /**
     * Equals
     */
    EQ = 'EQ',
    /**
     * Does not equal
     */
    NE = 'NE',
    /**
     * Less than
     */
    LT = 'LT',
    /**
     * Less than or equal to
     */
    LE = 'LE',
    /**
     * Greater than
     */
    GT = 'GT',
    /**
     * Greater than or equal to
     */
    GE = 'GE',
    /**
     * Contains
     */
    CONTAINS = 'CONTAINS',
    /**
     * Begins with
     */
    BEGINS_WITH = 'BEGINS_WITH',
    /**
     * Ends with
     */
    ENDS_WITH = 'ENDS_WITH',
    /**
     * Between, inclusive of higher value
     */
    BW_INC_MAX = 'BW_INC_MAX',
    /**
     * Between, inclusive of lower value
     */
    BW_INC_MIN = 'BW_INC_MIN',
    /**
     * Between, inclusive of both higher and lower value
     */
    BW_INC = 'BW_INC',
    /**
     * Between, non-inclusive
     */
    BW = 'BW',
    /**
     * Is included in this list of values
     */
    IN = 'IN',
    /**
     * Is not included in this list of values
     */
    NOT_IN = 'NOT_IN',
}

/**
 * Home page modules that can be hidden
 * via `hiddenHomepageModules` and reordered via
 * `reorderedHomepageModules`.
 *
 * **Note**: The classic (V1) and Modular (V2) home page experiences are
 * deprecated. These modules apply to V3 (ModularWithStylingChanges) and
 * V4 (Focused) home page experiences.
 * @version SDK: 1.28.0 | ThoughtSpot: 9.12.5.cl, 10.1.0.sw
 */

export enum HomepageModule {
    /**
     * Search bar
     */
    Search = 'SEARCH',
    /**
     * KPI watchlist module
     */
    Watchlist = 'WATCHLIST',
    /**
     * Favorite module
     */
    Favorite = 'FAVORITE',
    /**
     * List of answers and Liveboards
     */
    MyLibrary = 'MY_LIBRARY',
    /**
     * Trending list
     */
    Trending = 'TRENDING',
    /**
     * Learning videos
     */
    Learning = 'LEARNING',
}

/**
 * List page columns that can be hidden.
 * **Note**: This option is applicable to full app embedding only.
 * @version SDK: 1.38.0 | ThoughtSpot: 10.9.0.cl
 */

export enum ListPageColumns {
    /**
     * Favorites
     */
    Favorites = 'FAVOURITE',
    /**
     * Favourite Use {@link ListPageColumns.Favorites} instead.
     * @deprecated This option is deprecated.
     */
    Favourite = Favorites,
    /**
     * Tags
     */
    Tags = 'TAGS',
    /**
     * Author
     */
    Author = 'AUTHOR',
    /**
     * Last viewed/Last modified
     */
    DateSort = 'DATE_SORT',
    /**
     * Share
     */
    Share = 'SHARE',
    /**
     * Verified badge/column
     */
    Verified = 'VERIFIED',
}

/**
 * A filter that can be applied to ThoughtSpot answers, Liveboards, or
 * visualizations at runtime.
 */
export interface RuntimeFilter {
    /**
     * The name of the column to filter on (case-sensitive)
     */
    columnName: string;
    /**
     * The operator to apply
     */
    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.
     */
    values: (number | boolean | string | bigint)[];
}
/**
 * A filter that can be applied to ThoughtSpot Answers, Liveboards, or
 * visualizations at runtime.
 */
export interface RuntimeParameter {
    /**
     * The name of the runtime parameter to filter on (case-sensitive)
     */
    name: string;
    /**
     * Values
     */
    value: number | boolean | string;
    /**
     * Whether the parameter is visible to the user (`UpdateParameters` only).
     */
    isVisibleToUser?: boolean;
    /**
     * Scope of the update (`UpdateParameters` only). Omitting it, or `level`,
     * targets the Liveboard level.
     */
    applicability?: Applicability;
}

/**
 * Event types emitted by the embedded ThoughtSpot application.
 *
 * 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);
 * }));
 * ```
 *
 * If you are using React components for embedding, you can register to any
 * events from the `EmbedEvent` list by using the `on<EventName>` convention.
 * For example,`onAlert`, `onCopyToClipboard` and so on.
 *  @example
 * ```js
 * // ...
 * const MyComponent = ({ dataSources }) => {
 *      const onLoad = () => {
 *      console.log(EmbedEvent.Load, {});
 *      };
 *
 *      return (
 *          <SearchEmbed
 *              dataSources={dataSources}
 *              onLoad = {logEvent("Load")}
 *          />
 *     );
 * };
 * ```
 * @group Events
 */

export 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.
     */
    Init = 'init',
    /**
     * Authentication has either succeeded or failed.
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @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.
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.Load, hideLoader)
     *    //hide loader
     * function hideLoader() {
     *   document.getElementById("loader");
     * }
     * ```
     */
    Load = 'load',
    /**
     * Data pertaining to an Answer, Liveboard or Spotter visualization is received.
     * The event payload includes the raw data of the object.
     * @return data -  Answer of Liveboard data
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.Data, payload => {
     *    console.log('data', payload);
     * })
     * ```
     * @important
     */
    Data = 'data',
    /**
     * Search query has been updated by the user.
     * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 8.4.1.sw
     * @example
     * ```js
     * searchEmbed.on(EmbedEvent.QueryChanged, payload => console.log('data', payload))
     * ```
     */
    QueryChanged = 'queryChanged',
    /**
     * A drill-down operation has been performed.
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @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.on(EmbedEvent.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
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @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.
     * @returns actionId - ID of the custom action
     * @returns payload {@link CustomActionPayload} - Response payload with the
     * Answer or Liveboard data
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @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 click actions on a visualization.
     * @return ContextMenuInputPoints - Data point that is double-clicked
     * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
     * @example
     * ```js
     * LiveboardEmbed.on(EmbedEvent.VizPointDoubleClick, payload => {
     *      console.log('VizPointDoubleClick', payload);
     * })
     * ```
     */
    VizPointDoubleClick = 'vizPointDoubleClick',
    /**
     * 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
     * embed.on(EmbedEvent.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,
     *   )
     * });
     * ```
     */
    VizPointClick = 'vizPointClick',
    /**
     * Fired when an error occurs in the embedded component.
     *
     * **Important:** This event fires for many reasons — including internal
     * validation warnings (e.g. `HOST_EVENT_VALIDATION`), configuration issues,
     * and transient errors that ThoughtSpot already handles gracefully inside the
     * iframe. **Do not call `embed.destroy()` or unmount the embed component on
     * every error.** Doing so will tear down the iframe and abort all in-flight
     * requests, causing the embed to fail entirely.
     *
     * Only treat the following codes as unrecoverable:
     * - `INIT_ERROR` — SDK was not initialised before render
     * - `LOGIN_FAILED` — authentication could not be completed
     *
     * All other error codes should be logged and inspected, not acted upon
     * destructively.
     *
     * **Note:** There is currently no dedicated event for a true unrecoverable
     * crash. A future `EmbedEvent.FatalError` event is planned to give customers
     * a clean signal for when the embed cannot recover and needs to be torn down.
     *
     * Error types include:
     * `API` - API call failure.
     * `FULLSCREEN` - Error when presenting a Liveboard in full screen mode.
     * `VALIDATION_ERROR` - Internal host event or configuration validation warning.
     *
     * For more information, see https://developers.thoughtspot.com/docs/events-app-integration#errorType
     * @returns error - An error object or message
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @example
     * ```js
     * // Recommended pattern — only destroy on truly fatal errors
     * embed.on(EmbedEvent.Error, (error) => {
     *   const FATAL_CODES = ['INIT_ERROR', 'LOGIN_FAILED'];
     *   if (FATAL_CODES.includes(error.data?.code)) {
     *     embed.destroy();
     *     return;
     *   }
     *   // Log all other errors — do not destroy
     *   console.warn('Embed error (non-fatal):', error);
     * });
     * ```
     * @example
     * ```js
     * // API error
     * SearchEmbed.on(EmbedEvent.Error, (error) => {
     *   console.log(error);
     *   // { errorType: "API", message: '...', code: '...' }
     * });
     * ```
     */
    Error = 'Error',
    /**
     * The embedded object has sent an alert.
     * @returns alert - An alert object
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 8.4.1.sw
     * @example
     * ```js
     * searchEmbed.on(EmbedEvent.Alert)
     * ```
     */
    Alert = 'alert',
    /**
     * The ThoughtSpot authentication session has expired.
     * @version SDK: 1.4.0 | ThoughtSpot: ts7.sep.cl, 8.4.1.sw
     * @example
     * ```js
     * appEmbed.on(EmbedEvent.AuthExpire, showAuthExpired)
     * //show auth expired banner
     * function showAuthExpired() {
     *    document.getElementById("authExpiredBanner");
     * }
     * ```
     */
    AuthExpire = 'ThoughtspotAuthExpired',
    /**
     * ThoughtSpot failed to validate the auth session.
     * @hidden
     */
    AuthFailure = 'ThoughtspotAuthFailure',

    /**
     * ThoughtSpot failed to re validate the auth session.
     * @hidden
     */
    IdleSessionTimeout = 'IdleSessionTimeout',

    /**
     * ThoughtSpot failed to validate the auth session.
     * @hidden
     */
    AuthLogout = 'ThoughtspotAuthLogout',
    /**
     * The height of the embedded Liveboard or visualization has been computed.
     * @returns data - The height of the embedded Liveboard or visualization
     * @hidden
     */
    EmbedHeight = 'EMBED_HEIGHT',
    /**
     * The center of visible iframe viewport is calculated.
     * @returns data - The center of the visible Iframe viewport.
     * @hidden
     */
    EmbedIframeCenter = 'EmbedIframeCenter',
    /**
     * 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
     * @example
     * ```js
     * searchbarEmbed.on(EmbedEvent.GetDataClick)
     *  .then(data => {
     *  console.log('Answer Data:', data);
     * })
     * ```
     */
    GetDataClick = 'getDataClick',
    /**
     * Detects the route change.
     * @version SDK: 1.7.0 | ThoughtSpot: 8.0.0.cl, 8.4.1.sw
     * @example
     * ```js
     * searchEmbed.on(EmbedEvent.RouteChange, payload =>
     *    console.log('data', payload))
     * ```
     */
    RouteChange = 'ROUTE_CHANGE',
    /**
     * The v1 event type for Data
     * @hidden
     */
    V1Data = 'exportVizDataToParent',
    /**
     * Emitted when the embed does not have cookie access. This happens
     * when third-party cookies are blocked by Safari or other
     * web browsers. `NoCookieAccess` can trigger.
     * @example
     * ```js
     * appEmbed.on(EmbedEvent.NoCookieAccess)
     * ```
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1.sw
     */
    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
     * @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',
    /**
     * Emits 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.
     * Use start:true to subscribe to when save is initiated, or end:true to subscribe to when save is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //Emit when action starts
     *  searchEmbed.on(EmbedEvent.Save, payload => {
     *    console.log('Save', payload)
     *  }, {
     *    start: true
     * })
     * //emit 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.on(EmbedEvent.Download, {
     * vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * })
     * ```
     */
    Download = 'download',
    /**
     * Emitted when the download action is triggered on an Answer.
     * Payload varies by context: {@link VizScopedRequest} (Search, Answer,
     * Liveboard), {@link RequiredVizRequest} (Spotter, vizId required). trigger()
     * accepts the union now; per-context enforced next release.
     *  Use start:true to subscribe to when download is initiated, or end:true to
     *  subscribe to when download is completed. Default is end:true.
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.0.sw
     * @example
     * ```js
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.DownloadAsPng, payload => {
     *   console.log('download PNG', payload)}, {start: true })
     * //emit 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
     * Payload varies by context: {@link VizScopedRequest} (Search, Answer; plus
     * liveboardId on Liveboard), {@link RequiredVizRequest} (Spotter). trigger()
     * accepts the union now; per-context enforced next release.
     *  Use start:true to subscribe to when download as PDF is initiated, or end:true to
     *  subscribe to when download as PDF is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.DownloadAsPdf, payload => {
     *   console.log('download PDF', payload)}, {start: true })
     * //emit 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.
     * Payload varies by context: {@link VizScopedRequest} (Search, Answer,
     * Liveboard), {@link RequiredVizRequest} (Spotter, vizId required). trigger()
     * accepts the union now; per-context enforced next release.
     *  Use start:true to subscribe to when download as CSV is initiated, or end:true to
     *  subscribe to when download as CSV is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.DownloadAsCsv, payload => {
     *   console.log('download CSV', payload)}, {start: true })
     * //emit 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.
     * Payload varies by context: {@link VizScopedRequest} (Search, Answer,
     * Liveboard), {@link RequiredVizRequest} (Spotter, vizId required). trigger()
     * accepts the union now; per-context enforced next release.
     *  Use start:true to subscribe to when download as XLSX is initiated, or end:true to
     *  subscribe to when download as XLSX is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
     *   console.log('download Xlsx', payload)}, { start: true })
     * //emit when action ends
     * searchEmbed.on(EmbedEvent.DownloadAsXlsx, payload => {
     *   console.log('download Xlsx', payload)})
     * ```
     */
    DownloadAsXlsx = 'downloadAsXlsx',
    /**
     * Emitted when the Download Liveboard as Continuous PDF action is triggered
     * on a Liveboard.
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.DownloadLiveboardAsContinuousPDF, payload => {
     *   console.log('download liveboard as continuous PDF', payload)})
     * ```
     */
    DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
    /**
     * Emitted when an Answer is deleted in the app
     *  Use start:true to subscribe to when delete is initiated, or end:true to subscribe
     *  to when delete is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit 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 the AI Highlights action is triggered on a Liveboard
     * @version SDK: 1.44.0 | ThoughtSpot: 10.15.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.AIHighlights, (payload) => {
     *   console.log('AI Highlights', payload);
     * })
     * ```
     */
    AIHighlights = 'AIHighlights',
    /**
     * Emitted when a user initiates the Pin action to
     *  add an Answer to a Liveboard.
     *  Use start:true to subscribe to when pin is initiated, or end:true to subscribe to
     *  when pin is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.Pin, payload => {
     *    console.log('pin', payload)
     * }, {
     * start: true
     * })
     * //emit 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
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.SpotIQAnalyze, payload => {
     *   console.log('SpotIQAnalyze', payload)
     * }, {
     * start: true
     * })
     * //emit 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
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.Share, payload => {
     *    console.log('Share', payload)
     * }, {
     * start: true
     * })
     * //emit 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.
     * @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
     * @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 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
     * searchEmbed.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 on
     * embedded Liveboard.
     * @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
     * on an embedded Liveboard.
     * @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 the **Export TML** action is triggered on an
     * an embedded object in the app
     *  Use start:true to subscribe to when export is initiated, or end:true to subscribe
     *  to when export is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit when action starts
     * searchEmbed.on(EmbedEvent.ExportTML, payload => {
     *     console.log('Export TML', payload)}, { start: true })
     * //emit when action ends
     * searchEmbed.on(EmbedEvent.ExportTML, payload => {
     *     console.log('Export TML', payload)})
     * ```
     */
    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
     * @example
     * ```js
     * appEmbed.on(EmbedEvent.SaveAsView, payload => {
     *    console.log('View', payload);
     * })
     * ```
     */
    SaveAsView = 'saveAsView',
    /**
     * Emitted when the user creates a copy of an Answer.
     *  Use start:true to subscribe to when copy and edit is initiated, or end:true to
     *  subscribe to when copy and edit is completed. Default is end:true.
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @example
     * ```js
     * //emit when action starts
     * appEmbed.on(EmbedEvent.CopyAEdit, payload => {
     *    console.log('Copy and edit', payload)}, {start: true })
     * //emit 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 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.
     * @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 ThoughtSpot app
     * @hidden
     */
    APP_INIT = 'appInit',
    /**
     * Internal event to clear the cached info
     * @hidden
     */
    CLEAR_INFO_CACHE = 'clearInfoCache',
    /**
     * 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.LiveboardInfo, 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
     * @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
     * Payload varies by context: {@link VizScopedRequest} (Liveboard),
     * {@link RequiredVizRequest} (Spotter, vizId required). trigger() accepts the
     * union now; per-context enforced next release.
     * @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
     * @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
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.Present)
     * ```
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.Present, {
     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * })
     * ```
     */
    Present = 'present',
    /**
     * 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.on(EmbedEvent.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.on(EmbedEvent.SchedulesList)
     * ```
     */
    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
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.Cancel)
     * ```
     */
    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
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.Explore,  {
     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     */
    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
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.CopyLink, {
     *   vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     */
    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, 9.5.0.sw
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.CrossFilterChanged, {
     *    vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     */
    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, 9.5.0.sw
     * @example
     * ```js
     * LiveboardEmbed.on(EmbedEvent.VizPointRightClick, payload => {
     *    console.log('VizPointClick', payload)
     * })
     * ```
     */
    VizPointRightClick = 'vizPointRightClick',
    /**
     * Emitted when a user clicks **Insert to slide** on a visualization
     * @hidden
     */
    InsertIntoSlide = 'insertInToSlide',
    /**
     * Emitted when a user changes any filter on a Liveboard.
     * Returns filter type and name, column name and ID, and runtime
     * filter details.
     * The payload includes an optional `applicability` attribute indicating the
     * scope of the changed filter. It contains a `level` (`LIVEBOARD`,
     * `TAB`, or `GROUP`) and, when `level` is `TAB` or `GROUP`, a
     * `targetId` with the GUID of the target. At `LIVEBOARD` level there
     * is no `targetId`, since the filter applies to the whole Liveboard.
     * The `applicability` attribute is available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl.
     * @example
     *
     * ```js
     * LiveboardEmbed.on(EmbedEvent.FilterChanged, (payload) => {
     *    console.log('payload', payload);
     *    // payload.data optionally includes applicability: { level, targetId }
     * })
     * ```
     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.5.0.sw
     */
    FilterChanged = 'filterChanged',
    /**
     * Emitted when a user updates a connection on the **Data** page
     * @version SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
     */
    UpdateConnection = 'updateConnection',
    /**
     * Emitted when a user updates a connection on the **Data** page
     * @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
     * Personalised view is updated.
     * This event is deprecated. Use {@link EmbedEvent.UpdatePersonalizedView} instead.
     * @returns viewName: string
     * @returns viewId: string
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    UpdatePersonalisedView = 'updatePersonalisedView',
    /**
     * Emitted when name, status (private or public) or filter values of a
     * Personalized view is updated.
     * @returns viewName: string
     * @returns viewId: string
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    UpdatePersonalizedView = UpdatePersonalisedView,
    /**
     * Emitted when a Personalised view is saved.
     * This event is deprecated. Use {@link EmbedEvent.SavePersonalizedView} instead.
     * @returns viewName: string
     * @returns viewId: string
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    SavePersonalisedView = 'savePersonalisedView',
    /**
     * Emitted when a Personalized view is saved.
     * @returns viewName: string
     * @returns viewId: string
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    SavePersonalizedView = SavePersonalisedView,
    /**
     * Emitted when a Liveboard is reset.
     * @returns viewName: string
     * @returns viewId: string
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     */
    ResetLiveboard = 'resetLiveboard',
    /**
     * Emitted when a PersonalisedView is deleted.
     * This event is deprecated. Use {@link EmbedEvent.DeletePersonalizedView} instead.
     * @returns views: string[]
     * @returns liveboardId: string
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DeletePersonalisedView = 'deletePersonalisedView',
    /**
     * Emitted when a PersonalizedView is deleted.
     * @returns views: string[]
     * @returns liveboardId: string
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DeletePersonalizedView = DeletePersonalisedView,
    /**
     * Emitted when a user selects a different Personalized View or
     * resets to the original/default view on a Liveboard.
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.ChangePersonalizedView, (data) => {
     *   console.log(data.viewName);    // 'Q4 Revenue' or 'Original View'
     *   console.log(data.viewId);      // '2a021a12-...' or null (default)
     *   console.log(data.liveboardId); // 'abc123...'
     *   console.log(data.isPublic);    // true | false
     * })
     * ```
     * @returns viewName: string - Name of the selected view,
     *   or 'Original View' when reset to default.
     * @returns viewId: string | null - GUID of the selected view,
     *   or null when reset to default.
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    ChangePersonalizedView = 'changePersonalisedView',
    /**
     * Emitted when a user creates a Worksheet.
     * @version SDK: 1.27.0 | ThoughtSpot: 9.8.0.cl, 9.8.0.sw
     */
    CreateWorksheet = 'createWorksheet',
    /**
     * Emitted when the *Ask Sage* is initialized.
     * @returns viewName: string
     * @returns viewId: string
     * @returns liveboardId: string
     * @returns isPublic: boolean
     * @version SDK: 1.29.0 | ThoughtSpot Cloud: 9.12.0.cl
     */
    AskSageInit = 'AskSageInit',
    /**
     * Emitted when a Liveboard or visualization is renamed.
     * @version SDK: 1.28.0 | ThoughtSpot: 9.10.5.cl, 10.1.0.sw
     */
    Rename = 'rename',
    /**
     *
     * This event allows developers to intercept search execution
     * and implement logic that decides whether Search Data should return
     * data or block the search operation.
     *
     * **Prerequisite**: Set`isOnBeforeGetVizDataInterceptEnabled` to `true`
     * to ensure that `EmbedEvent.OnBeforeGetVizDataIntercept` is emitted
     * when the embedding application user tries to run a search query.
     *
     * This framework applies only to `AppEmbed` and `SearchEmbed`.
     * @param - Includes the following parameters:
     * - `payload`: The payload received from the embed related to the Data API call.
     * - `responder`: Contains elements that let developers define whether ThoughtSpot
     *   will run or block the search operation, and if blocked, which error message to
     *   provide.
     * - `execute` - When `execute` returns `true`, the search is run.
     * When `execute` returns `false`, the search is not executed.
     * - `error` - Developers can customize the user-facing error message when `execute`
     * is `false` by using the `error` parameters in `responder`.
     * - `errorText` - The error message text shown to the user.
     * @version SDK: 1.29.0 | ThoughtSpot: 10.3.0.cl
     * @example
     *
     * This example blocks search operation and returns a custom error message:
     * ```js
     * embed.on(EmbedEvent.OnBeforeGetVizDataIntercept, (payload, responder) => {
     *   responder({
     *     data: {
     *       execute: false,
     *       error: {
     *         // Provide a custom error message to explain why the search did not run.
     *         errorText: 'This search query cannot be run. Please contact your administrator for more details.',
     *       },
     *     },
     *   });
     * })
     * ```
     * @example
     *
     * This example allows the search operation to run
     * unless the query contains both `sales` and `county`,
     * and returns a custom error message if the query is rejected:
     * ```js
     * embed.on(EmbedEvent.OnBeforeGetVizDataIntercept, (payload, responder) => {
     *   // Record the search query submitted by the end user.
     *   const query = payload.data.data.answer.search_query;
     *
     *   responder({
     *     data: {
     *       // Returns true as long as the query does not include both `sales` and `county`.
     *       execute: !(query.includes('sales') && query.includes('county')),
     *       error: {
     *         // Provide a custom error message when the query is blocked by your logic.
     *         errorText:
     *           "You can't use this query: "
     *           + query
     *           + ". The 'sales' measure can never be used at the 'county' level. "
     *           + "Please try another measure or remove 'county' from your search.",
     *       },
     *     },
     *   });
     * })
     * ```
     */
    OnBeforeGetVizDataIntercept = 'onBeforeGetVizDataIntercept',
    /**
     * Emitted when parameter changes in an Answer
     * or Liveboard.
     * The payload includes an optional `applicability` attribute indicating the
     * scope of the changed parameter. It contains a `level` (`LIVEBOARD`,
     * `TAB`, or `GROUP`) and, when `level` is `TAB` or `GROUP`, a
     * `targetId` with the GUID of the target. At `LIVEBOARD` level there
     * is no `targetId`, since the parameter applies to the whole Liveboard.
     * The `applicability` attribute is available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl.
     * ```js
     * liveboardEmbed.on(EmbedEvent.ParameterChanged, (payload) => {
     *     console.log('payload', payload);
     *     // payload.data optionally includes applicability: { level, targetId }
     * })
     * ```
     * @version SDK: 1.29.0 | ThoughtSpot: 10.3.0.cl
     */
    ParameterChanged = 'parameterChanged',
    /**
     * Emits when a table visualization is rendered in
     * the ThoughtSpot embedded app.
     *
     * You can also use this event as a hook to trigger host events
     * such as `HostEvent.TransformTableVizData` on the table visualization.
     * The event payload contains the data used in the rendered table.
     * You can extract the relevant data from the payload
     * stored in `payload.data.data.columnDataLite`.
     *
     * `columnDataLite` is a multidimensional array that contains
     * data values for each column, which was used in the query to
     * generate the table visualization. To find and modify specific cell data,
     * you can either loop through the array or directly access a cell if
     * you know its position and data index.
     *
     * In the following code sample, the first cell in the first column
     * (`columnDataLite[0].dataValue[0]`) is set to `new fob`.
     * Note that any changes made to the data in the payload will only update the
     * visual presentation and do not affect the underlying data.
     * To persist data value modifications after a reload or during chart
     * interactions such as drill down, ensure that the modified
     * payload in the `columnDataLite` is passed on to
     * `HostEvent.TransformTableVizData` and trigger an update to
     * the table visualization.
     *
     * If the Row-Level Security (RLS) rules are applied on the
     * Model, exercise caution when changing column
     * or table cell values to maintain data security.
     *
     * @example
     * ```js
     * searchEmbed.on(EmbedEvent.TableVizRendered, (payload) => {
     *      console.log(payload);
     *      const columnDataLite = payload.data.data.columnDataLite;
     *      columnDataLite[0].dataValue[0]="new fob";
     *      console.log('>>> new Data', columnDataLite);
     *      searchEmbed.trigger(HostEvent.TransformTableVizData, columnDataLite);
     * })
     * ```
     * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
     */
    TableVizRendered = 'TableVizRendered',
    /**
     * Emitted when the liveboard is created from pin modal or Liveboard list page.
     * You can use this event as a hook to trigger
     * other events on liveboard creation.
     *
     * ```js
     * liveboardEmbed.on(EmbedEvent.CreateLiveboard, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
     */
    CreateLiveboard = 'createLiveboard',
    /**
     * Emitted when a user creates a Model.
     * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
     */
    CreateModel = 'createModel',
    /**
     * @hidden
     * Emitted when a user exits present mode.
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    ExitPresentMode = 'exitPresentMode',
    /**
     * Emitted when a user requests the full height lazy load data.
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     * @hidden
     */
    RequestVisibleEmbedCoordinates = 'requestVisibleEmbedCoordinates',
    /**
     * Emitted when Spotter response is text data
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterData, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     */
    SpotterData = 'SpotterData',
    /**
     * Emitted when user opens up the data source preview modal in Spotter embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.PreviewSpotterData, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     */
    PreviewSpotterData = 'PreviewSpotterData',
    /**
     * Emitted when user opens up the Add to Coaching modal on any visualization in Spotter Embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.AddToCoaching, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     */
    AddToCoaching = 'addToCoaching',
    /**
     * Emitted when user opens up the data model instructions modal in Spotter embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.DataModelInstructions, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
     */
    DataModelInstructions = 'DataModelInstructions',
    /**
     * Emitted when the Spotter query is triggered in Spotter embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterQueryTriggered, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     */
    SpotterQueryTriggered = 'SpotterQueryTriggered',
    /**
     * Emitted when the last Spotter query is edited in Spotter embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.LastPromptEdited, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     */
    LastPromptEdited = 'LastPromptEdited',
    /**
     * Emitted when the last Spotter query is deleted in Spotter embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.LastPromptDeleted, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     */
    LastPromptDeleted = 'LastPromptDeleted',
    /**
     * Emitted when the conversation is reset in Spotter embed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.ResetSpotterConversation, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     */
    ResetSpotterConversation = 'ResetSpotterConversation',
    /**
     * Emitted when the *Spotter* is initialized.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterInit, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     */
    SpotterInit = 'spotterInit',
    /**
     * Emitted when a *Spotter* conversation has been successfully created.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterLoadComplete, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.44.0 | ThoughtSpot: 26.2.0.cl
     */
    SpotterLoadComplete = 'spotterLoadComplete',
    /**
     * @hidden
     * Triggers when the embed listener is ready to receive events.
     * This is used to trigger events after the embed container is loaded.
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.EmbedListenerReady, () => {
     *     console.log('EmbedListenerReady');
     * })
     * ```
     */
    EmbedListenerReady = 'EmbedListenerReady',
    /**
     * Emitted when the organization is switched.
     * @example
     * ```js
     * appEmbed.on(EmbedEvent.OrgSwitched, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     */
    OrgSwitched = 'orgSwitched',
    /**
     * Emitted before the embedded ThoughtSpot app sends a network request whose
     * fully resolved URL matches one of the `interceptUrls` in the view config.
     * The request is held until you call `responder`, which decides whether the
     * real request goes out or a response you supply is used in its place.
     *
     * Setting `interceptUrls` is what enables this; there is no separate enable
     * flag. If `responder` is not called within `interceptTimeout` (30000 ms by
     * default) the request fails and `EmbedEvent.Error` is emitted.
     *
     * The payload is `{ input, init, urlType }`, where `input` is the request
     * URL and `init` is the `fetch` init object, with `init.body` parsed into an
     * object when it is valid JSON. `urlType` is the matching
     * `InterceptedApiType`; it is `InterceptedApiType.ALL` for any URL outside
     * the recognized API groups.
     *
     * Interception wraps the outermost layer of `fetch`, so `init` holds the
     * request as the application composed it, before ThoughtSpot attaches its
     * authentication headers. Those headers, and any token refresh and retry,
     * are applied afterwards and only when you pass `execute: true`. Only
     * requests made through `fetch` are intercepted.
     *
     * Pass `execute: true` to let the original request proceed untouched, in
     * which case any `response` you supply alongside it is ignored. With
     * `execute: false` the request is never sent, and your `response.body` is
     * returned to the app as JSON, defaulting to status 200 and a
     * `Content-Type: application/json` header.
     *
     * Supported on all embed types.
     *
     * @example
     *
     * ```js
     * embed.on(EmbedEvent.ApiIntercept, (payload, responder) => {
     *     console.log('payload', payload);
     *     responder({
     *         data: {
     *             execute: false,
     *             error: {
     *                 errorText: 'Error Occurred',
     *             }
     *         }
     *     })
     * })
     * ```
     *
     * ```js
     * // We can also send a response for the intercepted api
     * embed.on(EmbedEvent.ApiIntercept, (payload, responder) => {
     *     console.log('payload', payload);
     *     responder({
     *         data: {
     *             execute: false,
     *             response: {
     *                body: {
     *                    data: {
     *                       // Some api response
     *                    },
     *                }
     *             }
     *         }
     *     })
     * })
     *
     * // here embed will use the response from the responder as the response for the api
     * ```
     *
     * ```js
     * // We can also send error in response for the intercepted api
     * embed.on(EmbedEvent.ApiIntercept, (payload, responder) => {
     *     console.log('payload', payload);
     *     responder({
     *         data: {
     *             execute: false,
     *             response: {
     *                body: {
     *                    errors: [{
     *                      title: 'Error Occurred',
     *                      description: 'Error Description',
     *                      isUserError: true,
     *                    }],
     *                    data: {},
     *                },
     *             }
     *         }
     *     })
     * })
     * ```
     * @version SDK: 1.43.0 | ThoughtSpot: 10.15.0.cl
     */
    ApiIntercept = 'ApiIntercept',
    /**
     * Emitted when a Spotter conversation is renamed.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationRenamed, (payload) => {
     *     console.log('Conversation renamed', payload);
     *     // payload: { convId: string, oldTitle: string, newTitle: string }
     * })
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
     */
    SpotterConversationRenamed = 'spotterConversationRenamed',
    /**
     * Emitted when a Spotter conversation is deleted.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationDeleted, (payload) => {
     *     console.log('Conversation deleted', payload);
     *     // payload: { convId: string, title: string }
     * })
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
     */
    SpotterConversationDeleted = 'spotterConversationDeleted',
    /**
     * Emitted when the header Share button is clicked. Fires `Start` then `End`
     * to bracket the interaction. App→host counterpart of the
     * `ShareSpotterConversation` host event (user-driven vs programmatic open).
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterShareConversationButtonHeaderClicked, (payload) => {
     *     // payload: { convId: string }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareConversationButtonHeaderClicked = 'spotterShareConversationButtonHeaderClicked',
    /**
     * Emitted when the sidebar Share item is clicked. Fires `Start` then `End`
     * to bracket the interaction.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterShareConversationMenuItemSidebarClicked, (payload) => {
     *     // payload: { convId: string }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareConversationMenuItemSidebarClicked = 'spotterShareConversationMenuItemSidebarClicked',
    /**
     * Emitted when a Spotter conversation is shared (recipients added, or a new
     * share created). The host builds its own link from shareId/convId + its
     * configured CONVERSATION_URL — no link string is sent. Distinct from
     * `SpotterShareModalConfirmButtonClicked`, which fires at click time before
     * the save resolves.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationShared, (payload) => {
     *     // payload: { convId: string, shareId: string,
     *     //            recipientsAdded: string[], recipientsRemoved: string[] }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterConversationShared = 'spotterConversationShared',
    /**
     * Emitted when access to a shared Spotter conversation is revoked
     * (recipients removed). `fullyRevoked` is true when the last sharee is removed
     * and the share is deleted entirely.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationShareRevoked, (payload) => {
     *     // payload: { convId: string, shareId: string,
     *     //            recipientsRemoved: string[], fullyRevoked: boolean }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterConversationShareRevoked = 'spotterConversationShareRevoked',
    /**
     * Emitted when a recipient opens a shared Spotter conversation (read-only
     * view). No shareId available viewer-side.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterSharedConversationViewed, (payload) => {
     *     // payload: { convId: string, sourceConvId: string }
     *     // convId = resolved snapshot conv id; sourceConvId = the shared URL id
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterSharedConversationViewed = 'spotterSharedConversationViewed',
    /**
     * Emitted when the user toggles the share-modal "include new messages since
     * last shared version" checkbox.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterShareIncludeNewMessagesCheckboxToggled, (payload) => {
     *     // payload: { convId: string, includeNewMessages: boolean }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareIncludeNewMessagesCheckboxToggled = 'spotterShareIncludeNewMessagesCheckboxToggled',
    /**
     * Emitted when the user dismisses the stale-snapshot info banner via its
     * cross (distinct from the include-new-messages checkbox toggle).
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterShareStaleInfoBannerDismissed, (payload) => {
     *     // payload: { convId: string }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareStaleInfoBannerDismissed = 'spotterShareStaleInfoBannerDismissed',
    /**
     * Emitted when the modal Share (confirm) button is clicked — fires at click
     * time, before the save resolves. Distinct from the `SpotterConversationShared`
     * / `SpotterConversationShareRevoked` result events.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterShareModalConfirmButtonClicked, (payload) => {
     *     // payload: { convId: string }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareModalConfirmButtonClicked = 'spotterShareModalConfirmButtonClicked',
    /**
     * Emitted when the share modal is dismissed via the Cancel button.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterShareModalCancelButtonClicked, (payload) => {
     *     // payload: { convId: string }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareModalCancelButtonClicked = 'spotterShareModalCancelButtonClicked',
    /**
     * Emitted when a recipient leaves the read-only shared view via the Exit
     * button.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterSharedConversationExitButtonClicked, (payload) => {
     *     // payload: { convId: string }
     * })
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterSharedConversationExitButtonClicked = 'spotterSharedConversationExitButtonClicked',
    /**
     * Emitted when a Spotter conversation is pinned.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationPinned, (payload) => {
     *     console.log('Conversation pinned', payload);
     *     // payload: { conversationId: string, pinnedAt: string (ISO 8601) }
     * })
     * ```
     */
    SpotterConversationPinned = 'spotterConversationPinned',
    /**
     * Emitted when a Spotter conversation is unpinned.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationUnpinned, (payload) => {
     *     console.log('Conversation unpinned', payload);
     *     // payload: { conversationId: string, unpinnedAt: string (ISO 8601) }
     * })
     * ```
     */
    SpotterConversationUnpinned = 'spotterConversationUnpinned',
    /**
     * Emitted when a Spotter conversation is selected/clicked.
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterConversationSelected, (payload) => {
     *     console.log('Conversation selected', payload);
     *     // payload: { convId: string, title: string, worksheetId: string }
     * })
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
     */
    SpotterConversationSelected = 'spotterConversationSelected',

    /**
     * Emitted when the Spotter agent finishes streaming/rendering a response.
     * Includes the conversation and message identifiers so the host app can
     * fetch the full conversation history via the REST API if needed.
     *
     * The payload data has the shape `{ convId: string, messageId: string }`.
     *
     * Works with SpotterEmbed as well as AppEmbed (when Spotter is reached
     * inside the full application).
     * @example
     * ```js
     * spotterEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
     *     console.log('Spotter response complete', payload);
     * })
     * ```
     * @example
     * ```js
     * appEmbed.on(EmbedEvent.SpotterResponseComplete, (payload) => {
     *     console.log('Spotter response complete', payload);
     * })
     * ```
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterResponseComplete = 'spotterResponseComplete',

    /**
     * @hidden
     * Emitted when the auth token is about to get expired and needs to be refreshed.
     * @example
     * ```js
     * embed.on(EmbedEvent.RefreshAuthToken, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
     */
    RefreshAuthToken = 'RefreshAuthToken',

    /**
     * Triggered whenever the page context changes, returning the current context along with the navigation stack.
     * @example
     * ```js
     * embed.on(EmbedEvent.EmbedPageContextChanged, (payload) => {
     *     console.log('payload', payload);
     * })
     * ```
     * @version SDK: 1.47.2 | ThoughtSpot: 26.3.0.cl
     */
    EmbedPageContextChanged = 'EmbedPageContextChanged',

    /**
     * Represents a special embed event that is triggered whenever any host event is
     * subscribed.
     *
     * You can listen to this event when you need to dispatch a host event during load or
     * render, particularly in situations where timing issues may occur.
     *
     * @example
     * ```js
     * embed.on(`${HostEvent.Save} Subscribed`, () => {
     *     // make action
     * });
     * ```
     * 
     * @example
     * ```js
     * embed.on(subscribedEvent(HostEvent.Save), () => {
     *     // make action
     * });
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.4.0.cl
     */
    Subscribed = 'Subscribed',
    
    /**
     * Emitted when a user clicks the **Send Test Email** button in the
     * Liveboard schedule modal. Requires `isSendNowLiveboardSchedulingEnabled`
     * to be enabled.
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SendTestScheduleEmail, (payload) => {
     *     console.log('Send test email', payload);
     *     // payload: { liveboardId: string, sendToSelf: boolean }
     * })
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
     */
    SendTestScheduleEmail = 'sendTestScheduleEmail',

    /**
     * Emitted when the SpotterViz panel mounts in embed mode.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizInit, (payload) => {
     *     console.log('SpotterViz initialized', payload);
     *     // payload: { liveboardId: string }
     * })
     * ```
     */
    SpotterVizInit = 'SpotterVizInit',

    /**
     * Emitted when the user submits a prompt in the SpotterViz panel.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizQueryTriggered, (payload) => {
     *     console.log('SpotterViz query triggered', payload);
     *     // payload: { query: string, sessionId: string }
     * })
     * ```
     */
    SpotterVizQueryTriggered = 'SpotterVizQueryTriggered',

    /**
     * Emitted when the SpotterViz agent finishes responding.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizResponseComplete, (payload) => {
     *     console.log('SpotterViz response complete', payload);
     *     // payload: { sessionId: string, messageId: string }
     * })
     * ```
     */
    SpotterVizResponseComplete = 'SpotterVizResponseComplete',

    /**
     * Emitted when a checkpoint is created in the SpotterViz panel.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizCheckpointCreated, (payload) => {
     *     console.log('SpotterViz checkpoint created', payload);
     *     // payload: { checkpointId: string, source: string, label: string }
     * })
     * ```
     */
    SpotterVizCheckpointCreated = 'SpotterVizCheckpointCreated',

    /**
     * Emitted when a checkpoint is restored in the SpotterViz panel.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizCheckpointRestored, (payload) => {
     *     console.log('SpotterViz checkpoint restored', payload);
     *     // payload: { checkpointId: string, newGenNumber: number }
     * })
     * ```
     */
    SpotterVizCheckpointRestored = 'SpotterVizCheckpointRestored',

    /**
     * Emitted when an error occurs in the SpotterViz panel.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizError, (payload) => {
     *     console.log('SpotterViz error', payload);
     * })
     * ```
     */
    SpotterVizError = 'SpotterVizError',

    /**
     * Emitted when the SpotterViz panel is closed.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.SpotterVizClosed, (payload) => {
     *     console.log('SpotterViz panel closed', payload);
     * })
     * ```
     */
    SpotterVizClosed = 'SpotterVizClosed',
    /**
     * Emitted when a user clicks the **Refresh** button in the
     * Liveboard header. Requires `enableLiveboardDataCache`
     * to be enabled.
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.RefreshLiveboardBrowserCache, (payload) => {
     *     console.log('Liveboard browser cache refreshed', payload);
     *     // payload: { liveboardId: string }
     * })
     * ```
     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
     */
    RefreshLiveboardBrowserCache = 'refreshLiveboardBrowserCache',    
}

/**
 * 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.
 * @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"]}
 * ]);
 * ```
 * @example
 * If using React components to embed, use the format shown in this example:
 *
 * ```js
 *  const selectVizs = () => {
 *      embedRef.current.trigger(HostEvent.SetVisibleVizs, [
 *         "715e4613-c891-4884-be44-aa8d13701c06",
 *         "3f84d633-e325-44b2-be25-c6650e5a49cf"
 *      ]);
 *    };
 * ```
 *
 *
 * You can also attach an Embed event to a Host event to trigger
 * a specific action as shown in this example:
 * @example
 * ```js
 *  const EmbeddedComponent = () => {
 *       const embedRef = useRef(null); // import { useRef } from react
 *       const onLiveboardRendered = () => {
 *          embedRef.current.trigger(HostEvent.SetVisibleVizs, ['viz1', 'viz2']);
 *      };
 *
 *      return (
 *          <LiveboardEmbed
 *              ref={embedRef}
 *              liveboardId="<liveboard-guid>"
 *              onLiveboardRendered={onLiveboardRendered}
 *          />
 *      );
 *  }
 * ```
 *
 * **Context Parameter (SDK: 1.45.2+)**
 *
 * Starting from SDK version 1.45.2 | ThoughtSpot: 26.3.0.cl, you can optionally pass a
 * `ContextType` as the third parameter to the `trigger` method to specify the context
 * from which the event is triggered. This helps ThoughtSpot understand the current page
 * context (Search, Answer, Liveboard, or Spotter) for better event handling.
 *
 * @example
 * ```js
 * import { HostEvent, ContextType } from '@thoughtspot/visual-embed-sdk';
 *
 * // Trigger Pin event with Search context
 * appEmbed.trigger(HostEvent.Pin, {
 *     vizId: "123",
 *     liveboardId: "456"
 * }, ContextType.Search);
 * ```
 *
 * @group Events
 */

export enum HostEvent {
    /**
     * Triggers a search operation with the search tokens specified in
     * the search query string.
     * Supported in `AppEmbed` and `SearchEmbed` deployments.
     * Includes the following properties:
     * Payload: {@link SearchRequest}.
     * @param - Includes the following keys:
     * - `searchQuery`: Query string with search tokens.
     * - `dataSources`: Data source GUID to search on.
     *   Although an array, only a single source is supported.
     * - `execute`: Executes search and updates the existing query.
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.Search, {
         searchQuery: "[sales] by [item type]",
         dataSources: ["cd252e5c-b552-49a8-821d-3eadaa049cca"],
         execute: true
       });
     * ```
     * @example
     * ```js
     * // Trigger search from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Search, {
     *     searchQuery: "[revenue] by [region]",
     *     dataSources: ["cd252e5c-b552-49a8-821d-3eadaa049cca"],
     *     execute: true
     * }, ContextType.Search);
     * ```
     */
    Search = 'search',
    /**
     * Triggers a drill on certain points of the specified column
     * Payload: {@link DrillDownRequest}; in Liveboard context vizId is required
     * ({@link RequiredVizRequest}). trigger() accepts the union now; per-context
     * enforced next release.
     * Includes the following properties:
     * @param - Includes the following keys:
     * - `points`: An object containing `selectedPoints` and/or `clickedPoint`
     *   to drill to. For example, `{ selectedPoints: [] }`.
     * - `columnGuid`: Optional. GUID of the column to drill by. If not provided,
     *   it will auto drill by the configured column.
     * - `autoDrillDown`: Optional. If `true`, the drill down will be done automatically
     *   on the most popular column.
     * - `vizId` (TS >= 9.8.0): Optional. The GUID of the visualization to drill in case
     *   of a Liveboard. In Spotter embed, `vizId` refers to the Answer ID and is
     *   **required**.
     * @example
     * ```js
     * 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,
     *       });
     * })
     * ```
     * @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
     *      },
     *      columnGuid: "<guid of the column to drill>",
     *      vizId: payload.data.vizId
     *    });
     *  })
     * ```
     * @example
     * ```js
     * // Drill down from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.DrillDown, {
     *     points: { clickedPoint, selectedPoints },
     *     autoDrillDown: true
     * }, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Drill down from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.DrillDown, {
     *     points: { clickedPoint, selectedPoints },
     *     columnGuid: "column-guid"
     * }, ContextType.Search);
     * ```
     * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
     */
    DrillDown = 'triggerDrillDown',
    /**
     * Apply filters
     * @hidden
     */
    Filter = 'filter',
    /**
     * Reload the Answer or visualization
     * @hidden
     */
    Reload = 'reload',
    /**
     * Get iframe URL for the current embed view.
     * Payload: none.
     * Response: {@link GetIframeUrlResponse}.
     * @example
     * ```js
     * const url = embed.trigger(HostEvent.GetIframeUrl);
     * console.log("iFrameURL",url);
     * ```
     * @example
     * ```js
     * // Get iframe URL from specific context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * const url = await appEmbed.trigger(HostEvent.GetIframeUrl, {}, ContextType.Answer);
     * console.log("iFrameURL", url);
     * ```
     * @returns iframeUrl - The URL currently loaded in the embedded iframe.
     * @version SDK: 1.35.0 | ThoughtSpot: 10.4.0.cl
     */
    GetIframeUrl = 'GetIframeUrl',
    /**
     * Display specific visualizations on a Liveboard.
     * Payload: `string[]`.
     * @param - An array of GUIDs of the visualization to show. The visualization IDs not passed
     *  in this parameter will be hidden.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, [
     *  '730496d6-6903-4601-937e-2c691821af3c',
     *  'd547ec54-2a37-4516-a222-2b06719af726'])
     * ```
     * @example
     * ```js
     * // Set visible vizs from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SetVisibleVizs, [
     *     '730496d6-6903-4601-937e-2c691821af3c',
     *     'd547ec54-2a37-4516-a222-2b06719af726'
     * ], ContextType.Liveboard);
     * ```
     * @version SDK: 1.6.0 | ThoughtSpot: ts8.nov.cl, 8.4.1.sw
     */
    SetVisibleVizs = 'SetPinboardVisibleVizs',
    /**
     * Set a Liveboard tab as an active tab.
     * Payload: {@link SetActiveTabRequest}.
     * @param - tabId - string of id of Tab to show
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SetActiveTab,{
     *  tabId:'730496d6-6903-4601-937e-2c691821af3c'
     * })
     * ```
     * @example
     * ```js
     * // Set active tab from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SetActiveTab, {
     *     tabId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.24.0 | ThoughtSpot: 9.5.0.cl, 9.5.1-sw
     */
    SetActiveTab = 'SetActiveTab',
    /**
     * Updates the runtime filters applied on a Liveboard. The filter
     * attributes passed with this event are appended to the existing runtime
     * filters applied on a Liveboard.
     *
     * **Note**: `HostEvent.UpdateRuntimeFilters` is supported in `LiveboardEmbed`
     * and `AppEmbed` only. In full application embedding, this event updates
     * the runtime filters applied on the Liveboard and saved Answer objects.
     *
     * Payload: {@link RuntimeFilter}[].
     * @param - Array of {@link RuntimeFilter} objects. Each item includes:
     * - `columnName`: Name of the column to filter on.
     * - `operator`: {@link RuntimeFilterOp} to apply. For more information, see
     *   link:https://developers.thoughtspot.com/docs/runtime-filters#rtOperator[Developer Documentation].
     * - `values`: List of operands. Some operators such as EQ and LE allow a single
     *   value, whereas BW and IN accept multiple values.
     *
     * **Note**: Updating runtime filters resets the ThoughtSpot
     * object to its original state and applies new filter conditions.
     * Any user changes (like drilling into a visualization)
     * will be cleared, restoring the original visualization
     * with the updated filters.
     *

     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
     *   {columnName: "state",operator: RuntimeFilterOp.EQ,values: ["michigan"]},
     *   {columnName: "item type",operator: RuntimeFilterOp.EQ,values: ["Jackets"]}
     * ])
     * ```
     * @example
     * ```js
     * // Update runtime filters from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.UpdateRuntimeFilters, [
     *     {columnName: "region", operator: RuntimeFilterOp.EQ, values: ["west"]},
     *     {columnName: "product", operator: RuntimeFilterOp.IN, values: ["shoes", "boots"]}
     * ], ContextType.Liveboard);
     * ```
     * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     * @important
     */
    UpdateRuntimeFilters = 'UpdateRuntimeFilters',
    /**
     * Navigate to a specific page in the embedded ThoughtSpot application.
     * This is the same as calling `appEmbed.navigateToPage(path, true)`.
     *
     * Accepts either a plain value or an object with `path`
     * and an optional `replace` flag.
     *
     * Payload: `string` | `number` | {@link NavigateRequest}.
     * @param data - A string path, a numeric history delta, or an object
     *   `{ path: string | number, replace?: boolean }`.
     *   - `path` — the route to navigate to, or a history delta such as `1`
     *     or `-1` (calls `window.history.go()`).
     *   - `replace` — when `true`, replaces the current history entry instead
     *     of pushing a new one (uses `window.location.replace`).
     *
     * @example
     * ```js
     * // Preferred: use navigateToPage directly
     * appEmbed.navigateToPage(-1);
     * 
     * // Numeric delta — go back one step
     * appEmbed.trigger(HostEvent.Navigate, -1);
     *
     * // String path — push a new history entry
     * appEmbed.trigger(HostEvent.Navigate, 'home');
     *
     * // Object format — replace current history entry
     * appEmbed.trigger(HostEvent.Navigate, { path: 'home', replace: true }); // SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * ```
     * @version SDK: 1.12.0 | ThoughtSpot: 8.4.0.cl, 8.4.1.sw
     */
    Navigate = 'Navigate',
    /**
     * Open the filter panel for a particular column.
     * Works with Search and Liveboard embed.
     * Payload: {@link OpenFilterRequest} (the cross-context superset). The
     * accepted fields vary by context: {@link OpenFilterLiveboardRequest},
     * {@link OpenFilterSpotterRequest}, {@link OpenFilterSearchRequest}.
     * @param - { columnId: string,
     *  name: string,
     *  type: ATTRIBUTE/MEASURE,
     *  dataType: INT64/CHAR/DATE }
     *
     * `applicability` - Optional. Scopes the filter to a specific target,
     * for example, a single Liveboard tab, so the panel for the correct
     * scoped filter is opened. Available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
     *
     *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
     *  - `targetId`: The GUID of the target, for example, the tab GUID.
     *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
     *    `level` is `LIVEBOARD`, since the filter applies to the whole
     *    Liveboard. Omitting `applicability` targets the `LIVEBOARD` level.
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.OpenFilter,
     *  {column: { columnId: '<column-GUID>', name: 'column name', type: 'ATTRIBUTE', dataType: 'INT64'}})
     * ```
     * @example
     * ```js
     * LiveboardEmbed.trigger(HostEvent.OpenFilter,
     *   { column: {columnId: '<column-GUID>'}})
     * ```
     * @example
     * ```js
     * // Open a filter scoped to a specific Liveboard tab
     * liveboardEmbed.trigger(HostEvent.OpenFilter, {
     *     column: { columnId: '<column-GUID>' },
     *     applicability: { level: 'TAB', targetId: '<tab-GUID>' }
     * });
     * ```
     * @example
     * ```js
     * // Open filter from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.OpenFilter, {
     *     column: { columnId: '<column-GUID>', name: 'region', type: 'ATTRIBUTE', dataType: 'CHAR'}
     * }, ContextType.Search);
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
     */
    OpenFilter = 'openFilter',
    /**
     * Open the add-filter modal of a Liveboard, the same dialog that the
     * *Add filter* button in the Liveboard edit header opens, so the host
     * app can start the add-filter flow from its own UI.
     *
     * The Liveboard must be in edit mode; the event is ignored otherwise.
     * Hiding the *Add filter* button with `hiddenActions:
     * [Action.AddFilter]` does not block this event, but disabling it with
     * `disabledActions` does.
     *
     * Unlike {@link HostEvent.OpenFilter}, which opens the panel of an
     * existing filter, this event starts the creation of a new filter.
     * @version SDK: 1.51.1 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.OpenAddFilterModal);
     * ```
     */
    OpenAddFilterModal = 'openAddFilterModal',
    /**
     * Open the add-parameter panel of a Liveboard, the same panel that the
     * *Add parameter* button in the Liveboard edit header opens.
     * Mirrors {@link HostEvent.OpenAddFilterModal} for parameters.
     *
     * The Liveboard must be in edit mode; the event is ignored otherwise.
     * Hiding the *Add parameter* button with `hiddenActions:
     * [Action.AddParameter]` does not block this event, but disabling it
     * with `disabledActions` does.
     * @version SDK: 1.51.1 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.OpenAddParameterModal);
     * ```
     */
    OpenAddParameterModal = 'openAddParameterModal',
    /**
     * Open the parameter panel for a particular parameter on a Liveboard.
     * Mirrors {@link HostEvent.OpenFilter} for parameters.
     * Payload: {@link OpenParameterRequest}.
     * @param - Includes the following keys:
     * - `parameter`: An object identifying the parameter to open, for
     *   example, `{ parameterId: '<parameter-GUID>' }`.
     * - `applicability`: Optional. Scopes the parameter to a specific target,
     *   for example, a single Liveboard tab, so the panel for the correct
     *   scoped parameter is opened. Includes the following attributes:
     *
     *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
     *    - `targetId`: The GUID of the target, for example, the tab GUID.
     *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
     *      `level` is `LIVEBOARD`, since the parameter applies to the whole
     *      Liveboard. Omitting `applicability` targets the `LIVEBOARD` level.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.OpenParameter, {
     *     parameter: { parameterId: '<parameter-GUID>' }
     * });
     * ```
     * @example
     * ```js
     * // Open a parameter scoped to a specific group
     * liveboardEmbed.trigger(HostEvent.OpenParameter, {
     *     parameter: { parameterId: '<parameter-GUID>' },
     *     applicability: { level: 'GROUP', targetId: '<group-GUID>' }
     * });
     * ```
     * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
     */
    OpenParameter = 'openParameter',
    /**
     * Add columns to the current search query.
     * Payload: `{ columnIds: string[] }`.
     * @param - { columnIds: string[] }
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.AddColumns, { columnIds: ['<column-GUID>','<column-GUID>'] })
     * ```
     * @example
     * ```js
     * // Add columns from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.AddColumns, {
     *     columnIds: ['col-guid-1', 'col-guid-2']
     * }, ContextType.Search);
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
     */
    AddColumns = 'addColumns',
    /**
     * Remove a column from the current search query.
     * Payload: `{ columnId: string }`.
     * @param - { columnId: string }
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.RemoveColumn, { columnId: '<column-Guid>' })
     * ```
     * @example
     * ```js
     * // Remove column from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.RemoveColumn, {
     *     columnId: 'column-guid'
     * }, ContextType.Search);
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl
     */
    RemoveColumn = 'removeColumn',
    /**
     * 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.
     * For more information, see
     * link:https://developers.thoughtspot.com/docs/fetch-data-and-report-apis#transient-lb-content[Liveboard data with unsaved changes].
     * Payload: none.
     * Response: {@link GetExportRequestForCurrentPinboardResponse}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.getExportRequestForCurrentPinboard).then(
     * data=>console.log(data))
     * ```
     * @returns data - Object with a `v2Content` string: the export request
     * payload for the current Liveboard.
     * @returns type - The passthrough event name,
     * `getExportRequestForCurrentPinboard`.
     * @version SDK: 1.13.0 | ThoughtSpot: 8.5.0.cl, 8.8.1.sw
     */
    getExportRequestForCurrentPinboard = 'getExportRequestForCurrentPinboard',
    /**
     * Trigger **Pin** action on an embedded object.
     * If no parameters are defined, the pin action is triggered
     * for the Answer that the user is currently on
     * and a modal opens for Liveboard selection.
     * To add an Answer or visualization to a Liveboard programmatically without
     * requiring additional user input via the *Pin to Liveboard* modal, define
     * the following parameters:
     *
     * Payload: {@link PinAnswerToLiveboardRequest}.
     * Response: {@link PinAnswerToLiveboardResponse}.
     * @param - Includes the following keys:
     * - `vizId`: GUID of the saved Answer or Spotter visualization ID to pin to a
     * Liveboard.
     *   Optional when pinning a new chart or table generated from a Search query.
     *   **Required** in Spotter Embed.
     * - `liveboardId`: GUID of the Liveboard to pin an Answer. If there is no Liveboard,
     *   specify the `newLiveboardName` parameter to create a new Liveboard.
     * - `tabId`: GUID of the Liveboard tab. Adds the Answer to the Liveboard tab
     *   specified in the code.
     * - `newVizName`: Name string for the Answer or visualization. If defined,
     *   this parameter adds a new visualization object or creates a copy of the
     *   Answer or visualization specified in `vizId`.
     *   Required.
     * - `newLiveboardName`: Name string for the Liveboard.
     *   Creates a new Liveboard object with the specified name.
     * - `newTabName`: Name of the tab. Adds a new tab Liveboard specified
     *   in the code.
     *
     * @example
     * ```js
     * const pinResponse = await appEmbed.trigger(HostEvent.Pin, {
     *     vizId: "123",
     *     newVizName: "Sales by region",
     *     liveboardId: "123",
     *     tabId: "123"
     *  });
     * ```
     * @example
     * ```js
     * const pinResponse = await appEmbed.trigger(HostEvent.Pin, {
     *     newVizName: "Total sales of Jackets",
     *     liveboardId: "123"
     *  });
     * ```
     *
     * @example
     * ```js
     * const pinResponse = await searchEmbed.trigger(HostEvent.Pin, {
     *     newVizName: "Sales by state",
     *     newLiveboardName: "Sales",
     *     newTabName: "Products"
     *  });
     * ```
     * @example
     * ```js
     * appEmbed.trigger(HostEvent.Pin)
     * ```
     * @example
     * ```js

    * // You can use the Data event dispatched on each answer creation to get the vizId and use in Pin host event.
    * let latestSpotterVizId = '';
    * spotterEmbed.on(EmbedEvent.Data, (payload) => {
    *   latestSpotterVizId = payload.data.id;
    * });
    *
    * spotterEmbed.trigger(HostEvent.Pin, { vizId: latestSpotterVizId });
    * ```
     * @example
     * ```js
     * // Using context parameter to specify the context type (SDK: 1.45.2+)
     * // Pin from a search answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Pin, {
     *     vizId: "123",
     *     newVizName: "Sales by region",
     *     liveboardId: "456"
     *  }, ContextType.Search);
     * ```
     * @example
     * ```js
     * // Pin from an answer context (explore modal/page) (SDK: 1.45.2+)
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Pin, {
     *     vizId: "789",
     *     newVizName: "Revenue trends",
     *     liveboardId: "456"
     *  }, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Pin from a spotter context (SDK: 1.45.2+)
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Pin, {
     *     vizId: latestSpotterVizId,
     *     newVizName: "AI-generated insights",
     *     liveboardId: "456"
     *  }, ContextType.Spotter);
     * ```
     *
     * @returns liveboardId - GUID of the Liveboard the Answer was pinned to.
     * @returns tabId - GUID of the tab within that Liveboard.
     * @returns vizId - GUID of the newly created visualization.
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    Pin = 'pin',
    /**
     * Trigger the **Show Liveboard details** action
     * on an embedded Liveboard.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.LiveboardInfo)
     *```
     * @example
     * ```js
     * // Show liveboard info from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.LiveboardInfo, {}, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    LiveboardInfo = 'pinboardInfo',
    /**
     * Trigger the **Schedule** action on an embedded Liveboard.
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     *  liveboardEmbed.trigger(HostEvent.Schedule)
     * ```
     * @example
     * ```js
     * // Schedule from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Schedule, {}, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    Schedule = 'subscription',
    /**
     * Trigger the **Manage schedule** action on an embedded Liveboard
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     *  liveboardEmbed.trigger(HostEvent.SchedulesList)
     * ```
     * @example
     * ```js
     * // Manage schedules from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SchedulesList, {}, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    SchedulesList = 'schedule-list',
    /**
     * Trigger the **Export TML** action on an embedded Liveboard or
     * Answer.
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.ExportTML)
     * ```
     * @example
     * ```js
     * // Export TML from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.ExportTML, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Export TML from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.ExportTML, {}, ContextType.Search);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    ExportTML = 'exportTSL',
    /**
     * Trigger the **Edit TML** action on an embedded Liveboard or
     * saved Answers in the full application embedding.
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.EditTML)
     * ```
     * @example
     * ```js
     * // Edit TML from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.EditTML, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Edit TML from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.EditTML, {}, ContextType.Search);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    EditTML = 'editTSL',
    /**
     * Trigger the **Update TML** action on an embedded Liveboard.
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateTML)
     * ```
     * @example
     * ```js
     * // Update TML from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.UpdateTML, {}, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    UpdateTML = 'updateTSL',
    /**
     * Trigger the **Download PDF** action on an embedded Liveboard,
     * visualization or Answer.
     *
     * Payload: {@link VizScopedRequest} plus optional `liveboardId`.
     * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
     *
     * **NOTE**: The **Download** > **PDF** action is available on
     * visualizations and Answers if the data is in tabular format.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.DownloadAsPdf)
     * ```
     * @example
     * ```js

    * // You can use the Data event dispatched on each answer creation to get the vizId and use in DownloadAsPdf host event.
    * let latestSpotterVizId = '';
    * spotterEmbed.on(EmbedEvent.Data, (payload) => {
    *   latestSpotterVizId = payload.data.id;
    * });
    *
    * spotterEmbed.trigger(HostEvent.DownloadAsPdf, { vizId: latestSpotterVizId });
    * ```
     * @example
     * ```js
     * // Download as PDF from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.DownloadAsPdf, {}, ContextType.Search);
     * ```
     * @example
     * ```js
     * // Download as PDF from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.DownloadAsPdf, {}, ContextType.Liveboard);
     * ```
     *
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    DownloadAsPdf = 'downloadAsPdf',
    /**
     * Trigger the **Download Liveboard as Continuous PDF** action on an
     * embedded Liveboard.
     *
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.DownloadLiveboardAsContinuousPDF)
     * ```
     *
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
    /**
     * Trigger the **AI Highlights** action on an embedded Liveboard
     *
     * Payload: none.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.AIHighlights)
     * ```
     * @version SDK: 1.44.0 | ThoughtSpot: 10.15.0.cl
     */
    AIHighlights = 'AIHighlights',
    /**
     * Trigger the **Make a copy** action on a Liveboard,
     * visualization, or Answer page.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.MakeACopy)
     * ```
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.MakeACopy, {
     * vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * @example
     * ```js
     * vizEmbed.trigger(HostEvent.MakeACopy)
     * ```
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.MakeACopy)
     * ```
     * @example
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in MakeACopy host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.MakeACopy, { vizId: latestSpotterVizId });
     * ```
     * @example
     * ```js
     * // Make a copy from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.MakeACopy, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Make a copy from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.MakeACopy, {}, ContextType.Search);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    MakeACopy = 'makeACopy',
    /**
     * Trigger the **Delete** action for a Liveboard.
     * Payload varies by context: {@link RequiredVizRequest} (Liveboard, vizId
     * required), {@link VizScopedRequest} (Search). trigger() accepts the union
     * now; per-context enforced next release.
     * @example
     * ```js
     * appEmbed.trigger(HostEvent.Remove)
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Remove)
     * ```
     * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl, 10.10.0.sw
     */
    Remove = 'delete',
    /**
     * Trigger the **Explore** action on a visualization.
     * Payload: {@link RequiredVizRequest}.
     * @param - an object with `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Explore, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * @example
     * ```js
     * // Explore from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Explore, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    Explore = 'explore',
    /**
     * Trigger the **Create alert** action on a KPI chart
     * in a Liveboard or saved Answer.
     * Payload: {@link VizScopedRequest}.
     * @param - an object with `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.CreateMonitor, {
     *  vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * })
     * ```
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.CreateMonitor)
     * ```
     * @example
     * ```js
     * // Create monitor from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.CreateMonitor, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Create monitor from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.CreateMonitor, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    CreateMonitor = 'createMonitor',
    /**
     * Trigger the **Manage alerts** action on a KPI chart
     * in a visualization or saved Answer.
     * Payload: {@link VizScopedRequest}.
     * @param - an object with `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.ManageMonitor, {
     *  vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * })
     * ```
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.ManageMonitor)
     * ```
     * @example
     * ```js
     * vizEmbed.trigger(HostEvent.ManageMonitor)
     * ```
     * @example
     * ```js
     * // Manage monitor from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.ManageMonitor, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Manage monitor from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.ManageMonitor, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    ManageMonitor = 'manageMonitor',
    /**
     * Trigger the **Edit** action on a Liveboard or a visualization
     * on a Liveboard.
     *
     * This event is not supported in visualization embed and search embed.
     * Payload: {@link VizScopedRequest}.
     * @param - Object parameter. Includes the following keys:
     * - `vizId`: To trigger the action for a specific visualization in Liveboard embed,
     *   pass in `vizId` as a key. In Spotter embed, `vizId` refers to the Answer ID and
     *   is **required**.
     *
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Edit)
     * ```
     * ```js
     * liveboardEmbed.trigger(HostEvent.Edit, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.Edit);
     * ```
     * @example
     * ```js
     * // Using context parameter to edit liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Edit, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Edit from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Edit, {}, ContextType.Search);
     * ```
     * * @example
     * ```js
     * // Edit from spotter context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Edit, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Spotter);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    Edit = 'edit',
    /**
     * Trigger the **Copy link** action on a Liveboard or visualization
     * Payload: {@link VizScopedRequest}.
     * @param - object - to trigger the action for a
     * specific visualization in Liveboard embed, pass in `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.CopyLink)
     * ```
     * ```js
     * liveboardEmbed.trigger(HostEvent.CopyLink, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.CopyLink)
     * ```
     * @example
     * ```js
     * // Copy link from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.CopyLink, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Copy link from liveboard visualization context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.CopyLink, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Copy link from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.CopyLink, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Copy link from liveboard visualization context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.CopyLink, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    CopyLink = 'embedDocument',
    /**
     * Trigger the **Present** action on a Liveboard or visualization
     * Payload: {@link VizScopedRequest}.
     * @param - object - to trigger the action for a specific visualization
     *  in Liveboard embed, pass in `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Present)
     * ```
     * ```js
     * liveboardEmbed.trigger(HostEvent.Present, {vizId: '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.Present)
     * ```
     * @example
     * ```js
     * // Present from liveboard visualization context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Present, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Present from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Present, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Present from liveboard visualization context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Present, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Present from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Present, {}, ContextType.Liveboard);
     * ```
     * @version SDK: 1.15.0 | ThoughtSpot: 8.7.0.cl, 8.8.1.sw
     */
    Present = 'present',
    /**
     * Get TML for the current search.
     * Payload: {@link GetTMLRequest}.
     * Response: `Record<string, any>`.
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.GetTML).then((tml) => {
     *   console.log(
     *      tml.answer.search_query // TML representation of the search query
     *   );
     * })
     * ```
     * @example
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in GetTML host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.GetTML, {
     *   vizId: latestSpotterVizId
     * }).then((tml) => {
     *   console.log(
     *      tml.answer.search_query // TML representation of the search query
     *   );
     * })
     * ```
     * @example
     * ```js
     * // Get TML from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.GetTML, {}, ContextType.Search).then((tml) => {
     *   console.log(tml.answer.search_query);
     * });
     * ```
     * @example
     * ```js
     * // Get TML from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.GetTML, {}, ContextType.Search).then((tml) => {
     *   console.log(tml.answer);
     * });
     * ```
     * @returns The TML representation of the current Answer, as an object.
     * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
     * @important
     */
    GetTML = 'getTML',
    /**
     * Trigger the **Show underlying data** action on a
     * chart or table.
     *
     * Payload: {@link VizScopedRequest}.
     * @param - an object with vizId as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.ShowUnderlyingData, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.ShowUnderlyingData)
     * ```
     * ```js
     * searchEmbed.trigger(HostEvent.ShowUnderlyingData)
     * ```
     * @example
     * ```js
     * // Show underlying data from liveboard visualization context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.ShowUnderlyingData, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Show underlying data from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.ShowUnderlyingData, {}, ContextType.Search);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    ShowUnderlyingData = 'showUnderlyingData',
    /**
     * Trigger the **Delete** action for a visualization
     * in an embedded Liveboard, or a chart or table
     * generated from Search.
     * Payload: {@link VizScopedRequest}.
     * @param - Liveboard embed takes an object with `vizId` as a key.
     * Can be left empty if embedding Search or visualization.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Delete, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * searchEmbed.trigger(HostEvent.Delete)
     * ```
     * @example
     * ```js
     * // Delete from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Delete, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Delete from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Delete, {}, ContextType.Search);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    Delete = 'onDeleteAnswer',
    /**
     * Trigger the **SpotIQ analyze** action on a
     * chart or table.
     * Payload: {@link VizScopedRequest}.
     * @param - Liveboard embed takes `vizId` as a
     * key. Can be left undefined when embedding Search or
     * visualization.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.SpotIQAnalyze)
     * ```
     * ```js
     * searchEmbed.trigger(HostEvent.SpotIQAnalyze)
     * ```
     * @example
     * ```js
     * // SpotIQ analyze from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.SpotIQAnalyze, { vizId: '730496d6-6903-4601-937e-2c691821af3c' }, ContextType.Search);
     * ```
     * @example
     * ```js
     * // SpotIQ analyze from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SpotIQAnalyze, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    SpotIQAnalyze = 'spotIQAnalyze',
    /**
     * Trigger the **Download** action on charts in
     * the embedded view.
     * Use {@link HostEvent.DownloadAsPng} instead.
     *
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     *
     * @deprecated from SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl ,9.4.1.sw
     * @param - `vizId` refers to the Visualization ID in Spotter embed and is required in Spotter embed.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Download, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * embed.trigger(HostEvent.Download)
     * ```
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in Download host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.Download, { vizId: latestSpotterVizId });
     * ```
     */
    Download = 'downloadAsPng',
    /**
     * Trigger the **Download** > **PNG** action on
     * charts in the embedded view.
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.DownloadAsPng,
     * {vizId:'730496d6-6903-4601-937e-2c691821af3c'})
     *
     * vizEmbed.trigger(HostEvent.DownloadAsPng)
     *
     * searchEmbed.trigger(HostEvent.DownloadAsPng)
     *
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in DownloadAsPng host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.DownloadAsPng, { vizId: latestSpotterVizId });
     * ```
     * @example
     * ```js
     * // Download as PNG from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.DownloadAsPng, {}, ContextType.Search);
     * ```
     *
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.4.1.sw
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    DownloadAsPng = 'downloadAsPng',
    /**
     * Trigger the **Download** > **CSV**  action on tables in
     * the embedded view.
     * Payload: {@link VizScopedRequest}.
     * @param - `vizId` refers to the Visualization ID in Spotter embed and is required in Spotter embed.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.DownloadAsCsv, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.DownloadAsCsv)
     * ```
     * ```js
     * searchEmbed.trigger(HostEvent.DownloadAsCsv)
     * ```
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in DownloadAsCsv host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.DownloadAsCsv, { vizId: latestSpotterVizId });
     * ```
     * @example
     * ```js
     * // Download as CSV from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.DownloadAsCsv, {}, ContextType.Search);
     * ```
     * @example
     * ```js
     * // Download as CSV from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.DownloadAsCsv, {}, ContextType.Search);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    DownloadAsCsv = 'downloadAsCSV',
    /**
     * Trigger the **Download** > **XLSX**  action on tables
     * in the embedded view.
     * Payload: {@link VizScopedRequest}.
     * @param - `vizId` refers to the Visualization ID in Spotter embed and is required in Spotter embed.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.DownloadAsXlsx, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.DownloadAsXlsx)
     * ```
     * ```js
     * searchEmbed.trigger(HostEvent.DownloadAsXlsx)
     * ```
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in DownloadAsXlsx host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.DownloadAsXlsx, { vizId: latestSpotterVizId });
     * ```
     * @example
     * ```js
     * // Download as XLSX from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.DownloadAsXlsx, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Download as XLSX from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.DownloadAsXlsx, {}, ContextType.Search);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    DownloadAsXlsx = 'downloadAsXLSX',
    /**
     * Trigger the **Share** action on an embedded
     * Liveboard or Answer.
     * Payload: {@link VizScopedRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.Share)
     * ```
     * ```js
     * searchEmbed.trigger(HostEvent.Share)
     * ```
     * @example
     * ```js
     * // Share from Liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.Share, {}, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Share from search-answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Share, {}, ContextType.Search);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    Share = 'share',
    /**
     * Trigger the **Save** action on a Liveboard, Answer, or Spotter.
     * Saves the changes.
     *
     * Payload: {@link VizScopedRequest}.
     * @param - `vizId` refers to the Spotter Visualization Id used in Spotter embed.
     * It is required and can be retrieved from the data embed event.
     *
     * @example
     * ```js
     * // Save changes in a Liveboard
     * liveboardEmbed.trigger(HostEvent.Save)
     * ```
     *
     * ```js
     * // Save the current Answer in Search embed
     * searchEmbed.trigger(HostEvent.Save)
     * ```
     *
     * ```js
     * // Save a Visualization in Spotter (requires vizId)
     * spotterEmbed.trigger(HostEvent.Save, {
     *   vizId: "730496d6-6903-4601-937e-2c691821af3c"
     * })
     * ```
     *
     * ```js
     * // How to get the vizId in Spotter?
     *
     * // You can use the Data event dispatched on each answer creation to get the vizId.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.Save, { vizId: latestSpotterVizId });
     * ```
     * @example
     * ```js
     * // Save from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.Save, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Save from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.Save, {}, ContextType.Search);
     * ```
     *
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    Save = 'save',
    /**
     * Trigger the **Sync to Sheets** action on an embedded visualization or Answer
     * Sends data from an Answer or Liveboard visualization to a Google sheet.
     * Payload: {@link VizScopedRequest}.
     * @param - an object with `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SyncToSheets, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.SyncToSheets)
     * ```
     * @example
     * ```js
     * // Sync to sheets from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.SyncToSheets, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Sync to sheets from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SyncToSheets, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    SyncToSheets = 'sync-to-sheets',
    /**
     * 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.
     * Payload: {@link VizScopedRequest}.
     * @param - an object with vizId as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.SyncToOtherApps)
     * ```
     * @example
     * ```js
     * // Sync to other apps from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.SyncToOtherApps, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Sync to other apps from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SyncToOtherApps, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    SyncToOtherApps = 'sync-to-other-apps',
    /**
     * Trigger the **Manage pipelines** action on an embedded
     * visualization or Answer.
     * Allows users to manage ThoughtSpot Sync pipelines.
     * Payload: {@link VizScopedRequest}.
     * @param - an object with `vizId` as a key
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.ManagePipelines, {vizId:
     * '730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * ```js
     * vizEmbed.trigger(HostEvent.ManagePipelines)
     * ```
     * @example
     * ```js
     * // Manage pipelines from answer context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * appEmbed.trigger(HostEvent.ManagePipelines, {}, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Manage pipelines from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.ManagePipelines, {
     *     vizId: '730496d6-6903-4601-937e-2c691821af3c'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.19.0 | ThoughtSpot: 9.0.0.cl, 9.0.1.sw
     */
    ManagePipelines = 'manage-pipeline',
    /**
     * Reset search operation on the Search or Answer page.
     * Payload: none.
     * @example
     * ```js
     * searchEmbed.trigger(HostEvent.ResetSearch)
     * ```
     * ```js
     * appEmbed.trigger(HostEvent.ResetSearch)
     * ```
     * @example
     * ```js
     * // Reset search from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * searchEmbed.trigger(HostEvent.ResetSearch, {}, ContextType.Search);
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.0.1.sw
     */
    ResetSearch = 'resetSearch',
    /**
     * Get details of filters applied on the Liveboard.
     * Returns arrays containing Liveboard filter and runtime filter elements.
     * Each Liveboard filter includes an optional `applicability` attribute
     * indicating the scope of the filter. It contains a `level`
     * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
     * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
     * level there is no `targetId`, since the filter applies to the
     * whole Liveboard.
     * The `applicability` attribute is available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl.
     * Payload: {@link GetFiltersRequest}.
     * Response: {@link GetFiltersResponse}.
     * @example
     * ```js
     * const data = await liveboardEmbed.trigger(HostEvent.GetFilters);
     *     console.log('data', data);
     * ```
     * @example
     * ```js
     * // Get filters from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * const data = await liveboardEmbed.trigger(HostEvent.GetFilters, {}, ContextType.Liveboard);
     * console.log('filters', data);
     * ```
     * @returns liveboardFilters - Filters applied on the Liveboard.
     * @returns runtimeFilters - Runtime filters applied on the Liveboard.
     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
     */
    GetFilters = 'getFilters',
    /**
     * Update one or several filters applied on a Liveboard.
     * Payload: {@link UpdateFiltersRequest}.
     * @param - Includes the following keys:
     * - `filter`: A single filter object containing column name, filter operator, and
     * values.
     * - `filters`: Multiple filter objects with column name, filter operator,
     * and values for each.
     *
     * Each filter object must include the following attributes:
     *
     * `column` - Name of the column to filter on.
     *
     * `oper`  - Filter operator, for example, EQ, IN, CONTAINS.
     *  For information about the supported filter operators,
     *  see link:https://developers.thoughtspot.com/docs/runtime-filters#rtOperator[Developer Documentation].
     *
     * `values` - An array of one or several values. The value definition on the
     *  data type you choose to filter on. For a complete list of supported data types,
     *  see
     *  link:https://developers.thoughtspot.com/docs/runtime-filters#_supported_data_types[Supported
     *  data types].
     *
     * `type`  - To update filters for date time, specify the date format type.
     * For more information and examples, see link:https://developers.thoughtspot.com/docs/embed-liveboard#_date_filters[Date filters].
     *
     * `applicability` - Optional. Scopes the filter to a specific target,
     * for example, a single Liveboard tab. Available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
     *
     *  - `level`: The scope of the filter: `LIVEBOARD`, `TAB`, or `GROUP`.
     *  - `targetId`: The GUID of the target, for example, the tab GUID.
     *    Required when `level` is `TAB` or `GROUP`. Do not pass it when
     *    `level` is `LIVEBOARD`, since the filter applies to the whole
     *    Liveboard.
     * @example
     * ```js
     *
     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
     *     filter: {
     *         column: "item type",
     *         oper: "IN",
     *         values: ["bags","shirts"]
     *        }
     *    });
     * ```
     * @example
     * ```js
     *
     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
     *     filter: {
     *         column: "date",
     *         oper: "EQ",
     *         values: ["JULY","2023"],
     *         type: "MONTH_YEAR"
     *        }
     *    });
     * ```
     * @example
     *
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
     *  filters: [{
     *      column: "Item Type",
     *      oper: 'IN',
     *      values: ["bags","shirts"]
     *  },
     *    {
     *      column: "Region",
     *      oper: 'IN',
     *      values: ["West","Midwest"]
     *  },
     *    {
     *      column: "Date",
     *      oper: 'EQ',
     *      values: ["2023-07-31"],
     *      type: "EXACT_DATE"
     *    }]
     * });
     * ```
     * If there are multiple columns with the same name, consider
     * using `WORKSHEET_NAME::COLUMN_NAME` format.
     *
     * @example
     *
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
     *  filters: [{
     *      column: "(Sample) Retail - Apparel::city",
     *      oper: 'IN',
     *      values: ["atlanta"]
     *  },
     *  {
     *      column: "(Sample) Retail - Apparel::Region",
     *      oper: 'IN',
     *      values: ["West","Midwest"]
     *  }]
     * });
     * ```
     * @example
     * ```js
     * // Update filters from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
     *     filter: {
     *         column: "item type",
     *         oper: "IN",
     *         values: ["shoes", "boots"]
     *     }
     * }, ContextType.Liveboard);
     * ```
     * @example
     * ```js
     * // Scope the filter to a specific Liveboard tab
     * liveboardEmbed.trigger(HostEvent.UpdateFilters, {
     *     filter: {
     *         column: "item type",
     *         oper: "IN",
     *         values: ["bags", "shirts"],
     *         applicability: {
     *             level: "TAB",
     *             targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
     *         }
     *     }
     * });
     * ```
     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl
     */
    UpdateFilters = 'updateFilters',
    /**
     * Get tab details for the current Liveboard.
     * Payload: none.
     * Response: {@link GetTabsResponse}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.GetTabs).then((tabDetails) => {
     *   console.log(
     *      tabDetails // TabDetails of current Liveboard
     *   );
     * })
     * ```
     * @example
     * ```js
     * // Get tabs from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.GetTabs, {}, ContextType.Liveboard).then((tabDetails) => {
     *     console.log('tabs', tabDetails);
     * });
     * ```
     * @returns orderedTabIds - Tab GUIDs in the order they appear.
     * @returns numberOfTabs - Total number of tabs on the Liveboard.
     * @returns Tabs - Tab details, each with at least `id` and `name`.
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     */
    GetTabs = 'getTabs',
    /**
     * Get group details for the current Liveboard.
     * Mirrors {@link HostEvent.GetTabs} for filter/parameter groups.
     * Payload: none.
     * Response: {@link GetGroupsResponse}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.GetGroups).then((groupDetails) => {
     *   console.log(
     *      groupDetails // GroupDetails of current Liveboard
     *   );
     * })
     * ```
     * @example
     * ```js
     * // Get groups from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.GetGroups, {}, ContextType.Liveboard).then((groupDetails) => {
     *     console.log('groups', groupDetails);
     * });
     * ```
     * @returns orderedGroupIds - Group GUIDs in the order they appear.
     * @returns numberOfGroups - Total number of groups on the Liveboard.
     * @returns Groups - Group details, each with at least `id` and `name`.
     * @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
     */
    GetGroups = 'getGroups',
    /**
     * Set the visible tabs on a Liveboard.
     * Payload: `string[]`.
     * @param - an array of ids of tabs to show, the IDs not passed
     *          will be hidden.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SetVisibleTabs, [
     *  '430496d6-6903-4601-937e-2c691821af3c',
     *  'f547ec54-2a37-4516-a222-2b06719af726'])
     * ```
     * @example
     * ```js
     * // Set visible tabs from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SetVisibleTabs, [
     *     '430496d6-6903-4601-937e-2c691821af3c',
     *     'f547ec54-2a37-4516-a222-2b06719af726'
     * ], ContextType.Liveboard);
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     */
    SetVisibleTabs = 'SetPinboardVisibleTabs',
    /**
     * Set the hidden tabs on a Liveboard.
     * Payload: `string[]`.
     * @param - an array of the IDs of the tabs to hide.
     * The IDs not passed will be shown.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
     *  '630496d6-6903-4601-937e-2c691821af3c',
     *  'i547ec54-2a37-4516-a222-2b06719af726'])
     * ```
     * @example
     * ```js
     * // Set hidden tabs from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.SetHiddenTabs, [
     *     '630496d6-6903-4601-937e-2c691821af3c',
     *     'i547ec54-2a37-4516-a222-2b06719af726'
     * ], ContextType.Liveboard);
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     */
    SetHiddenTabs = 'SetPinboardHiddenTabs',
    /**
     * Get the Answer session for a Search or
     * Liveboard visualization.
     *
     * Note: This event is not typically used directly. Instead, use the
     * `getAnswerService()` method on the embed instance to get an AnswerService
     * object that provides a more convenient interface for working with answers.
     *
     * Payload: {@link GetAnswerSessionRequest}.
     * Response: {@link GetAnswerSessionResponse}.
     * @example
     * ```js
     * // Preferred way to get an AnswerService
     * const service = await embed.getAnswerService();
     *
     * // Alternative direct usage (not recommended)
     * const {session} = await embed.trigger(
     *  HostEvent.GetAnswerSession, {
     *      vizId: '123', // For Liveboard Visualization.
     *  })
     * ```
     * @example
     * ```js
     * // Preferred way to get an AnswerService
     * const service = await embed.getAnswerService();
     *
     * // Alternative direct usage (not recommended)
     * const {session} = await embed.trigger( HostEvent.GetAnswerSession )
     * ```
     * @returns session - Session identifier for the Answer, for use with the
     * `AnswerService`.
     * @returns embedAnswerData - Data backing the Answer, when available.
     * @version SDK: 1.26.0 | ThoughtSpot: 9.10.0.cl, 10.1.0.sw
     */
    GetAnswerSession = 'getAnswerSession',
    /**
     * Trigger the *Ask Sage* action for visualizations
     * Payload: {@link RequiredVizRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.AskSage,
     * {vizId:'730496d6-6903-4601-937e-2c691821af3c'})
     * ```
     * @version SDK: 1.29.0 | ThoughtSpot Cloud: 9.12.0.cl
     */
    AskSage = 'AskSage',
    /**
     * Trigger cross filter update action on a Liveboard.
     *
     * Payload: {@link UpdateCrossFilterRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateCrossFilter, {
     *      vizId: 'b535c760-8bbe-4e6f-bb26-af56b4129a1e',
     *      conditions: [
     *      { columnName: 'Category', values: ['mfgr#12','mfgr#14'] },
     *      { columnName: 'color', values: ['mint','hot'] },
     *    ],
     * });
     * ```
     * @version SDK: 1.29.0 | ThoughtSpot Cloud: 10.0.0.cl, 10.1.0.sw
     */
    UpdateCrossFilter = 'UpdateCrossFilter',
    /**
     * Trigger reset action for a personalized Liveboard view.
     * This event is deprecated.
     * Use {@link HostEvent.ResetLiveboardPersonalizedView} instead.
     * Payload: none.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.ResetLiveboardPersonalisedView);
     * ```
     * @version SDK: 1.29.0 | ThoughtSpot Cloud: 10.1.0.cl, 10.1.0.sw
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    ResetLiveboardPersonalisedView = 'ResetLiveboardPersonalisedView',
    /**
     * Trigger reset action for a personalized Liveboard view.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.ResetLiveboardPersonalizedView);
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    ResetLiveboardPersonalizedView = ResetLiveboardPersonalisedView,
    /**
     * Triggers an action to update Parameter values on embedded
     * Answers, Liveboard, and Spotter answer in Edit mode.
     * Payload: {@link RuntimeParameter}[].
     * @param - Includes the following keys for each item:
     * - `name`: Name of the parameter.
     * - `value`: The value to set for the parameter.
     * - `isVisibleToUser`: Optional. To control the visibility of the parameter chip.
     * - `applicability`: Optional. Scopes the parameter to a specific target,
     * for example, a single Liveboard tab. Available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl. Includes the following attributes:
     *
     *    - `level`: The scope of the parameter: `LIVEBOARD`, `TAB`, or `GROUP`.
     *    - `targetId`: The GUID of the target, for example, the tab GUID.
     *      Required when `level` is `TAB` or `GROUP`. Do not pass it when
     *      `level` is `LIVEBOARD`, since the parameter applies to the whole
     *      Liveboard.
     *
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
     *   name: "Integer Range Param",
     *   value: 10,
     *   isVisibleToUser: false
     * }])
     * ```
     * @example
     * ```js
     * // Scope the parameter to a specific Liveboard tab
     * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
     *   name: "Integer Range Param",
     *   value: 10,
     *   applicability: {
     *     level: "TAB",
     *     targetId: "e0836cad-4fdf-42d4-bd97-567a6b2a6058"
     *   }
     * }])
     * ```
     * @example
     * ```js
     * // Update parameters from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.UpdateParameters, [{
     *     name: "Region Param",
     *     value: "West",
     *     isVisibleToUser: true
     * }], ContextType.Liveboard);
     * ```
     * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
     */
    UpdateParameters = 'UpdateParameters',
    /**
     * Triggers GetParameters to fetch the runtime Parameters.
     * Each parameter includes an optional `applicability` attribute
     * indicating the scope of the parameter. It contains a `level`
     * (`LIVEBOARD`, `TAB`, or `GROUP`) and, when `level` is `TAB` or
     * `GROUP`, a `targetId` with the GUID of the target. At `LIVEBOARD`
     * level there is no `targetId`, since the parameter applies to the
     * whole Liveboard.
     * The `applicability` attribute is available from SDK: 1.53.0 |
     * ThoughtSpot: 26.10.0.cl.
     * Payload: none.
     * Response: {@link GetParametersResponse}.
     * @param - `vizId` refers to the Answer ID in Spotter embed and is required in Spotter embed.
     * ```js
     * liveboardEmbed.trigger(HostEvent.GetParameters).then((parameter) => {
     *  console.log('parameters', parameter);
     * });
     * ```
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in GetParameters host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.GetParameters, { vizId: latestSpotterVizId });
     *```
     * @example
     * ```js
     * // Get parameters from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.GetParameters, {},
     * ContextType.Liveboard).then((parameters) => {
     *     console.log('parameters', parameters);
     * });
     * ```
     * @returns parameters - Parameters currently applied on the Liveboard.
     * @version SDK: 1.29.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
     */
    GetParameters = 'GetParameters',
    /**
     * Triggers an event to update a personalized view of a Liveboard.
     * This event is deprecated. Use {@link HostEvent.SelectPersonalizedView} instead,
     * which additionally accepts a `viewName`, resets to the original view when
     * called with an empty payload, and reports an error when a named view
     * cannot be found.
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
     * ```
     * Payload: {@link PersonalisedViewRequest} (`viewId` only).
     * @example
     * ```js
     * // Update personalized view from liveboard context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {
     *     viewId: '1234'
     * }, ContextType.Liveboard);
     * ```
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    UpdatePersonalisedView = 'UpdatePersonalisedView',
    /**
     * Triggers an event to update a personalized view of a Liveboard.
     * This event is deprecated. Use {@link HostEvent.SelectPersonalizedView} instead,
     * which additionally accepts a `viewName`, resets to the original view when
     * called with an empty payload, and reports an error when a named view
     * cannot be found.
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdatePersonalisedView, {viewId: '1234'})
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     * @deprecated SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
     */
    UpdatePersonalizedView = UpdatePersonalisedView,
    /**
     * Triggers selection of a specific Personalized View on a
     * Liveboard without reloading the embed. Pass either a
     * `viewId` (GUID) or `viewName`. If both are provided, `viewId` takes precedence.
     * If neither is provided, the Liveboard resets to the original/default view.
     * When a `viewName` is provided and multiple views share
     * the same name, the first match is selected.
     * Payload: {@link PersonalisedViewRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(
     *   HostEvent.SelectPersonalizedView,
     *   { viewId: '2a021a12-1aed-425d-984b-141ee916ce72' },
     * )
     * ```
     * @example
     * ```js
     * // Select by name
     * liveboardEmbed.trigger(
     *   HostEvent.SelectPersonalizedView,
     *   { viewName: 'Dr Smith Cardiology' },
     * )
     * ```
     * @example
     * ```js
     * // Reset to default view
     * liveboardEmbed.trigger(
     *   HostEvent.SelectPersonalizedView,
     *   {},
     * )
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    SelectPersonalizedView = 'SelectPersonalisedView',
    /**
     * @hidden
     * Notify when info call is completed successfully
     * ```js
     * liveboardEmbed.trigger(HostEvent.InfoSuccess, data);
     * ```
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     */
    InfoSuccess = 'InfoSuccess',
    /**
     * Trigger the save action for an Answer.
     * To programmatically save an answer without opening the
     * *Describe your Answer* modal, define the `name` and `description`
     * properties.
     * If no parameters are specified, the save action is
     * triggered with a modal to prompt users to
     * add a name and description for the Answer.
     * Payload: {@link SaveAnswerRequest}.
     * Response: {@link SaveAnswerResponse}.
     * @param - Includes the following keys:
     * - `vizId`: Refers to the Answer ID in Spotter embed and is **required** in Spotter
     * embed.
     * - `name`: Optional. Name string for the Answer.
     * - `description`: Optional. Description text for the Answer.
     * @example
     * ```js
     * const saveAnswerResponse = await searchEmbed.trigger(HostEvent.SaveAnswer, {
     *      name: "Sales by states",
     *      description: "Total sales by states in MidWest"
     *   });
     * ```
     * @example
     * ```js
     * // You can use the Data event dispatched on each answer creation to get the vizId and use in SaveAnswer host event.
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.SaveAnswer, { vizId: latestSpotterVizId });
     * ```
     * @example
     * ```js
     * // Using context parameter to save answer from search context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * const saveAnswerResponse = await appEmbed.trigger(HostEvent.SaveAnswer, {
     *      name: "Regional sales analysis",
     *      description: "Sales breakdown by region"
     *   }, ContextType.Search);
     * ```
     * @example
     * ```js
     * // Save answer from answer context (explore modal)
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * const saveAnswerResponse = await appEmbed.trigger(HostEvent.SaveAnswer, {
     *      name: "Modified analysis",
     *      description: "Updated from explore view"
     *   }, ContextType.Answer);
     * ```
     * @example
     * ```js
     * // Save answer from spotter context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * const saveAnswerResponse = await appEmbed.trigger(HostEvent.SaveAnswer, {
     *      vizId: latestSpotterVizId,
     *      name: "AI insights",
     *      description: "Generated from Spotter"
     *   }, ContextType.Spotter);
     * ```
     * @returns answerId - GUID of the saved Answer.
     * @returns saveResponse - Raw response from the save operation.
     * @returns shareResponse - Raw response from the share operation, when the
     * Answer was also made discoverable.
     * @version SDK: 1.36.0 | ThoughtSpot: 10.6.0.cl
     */
    SaveAnswer = 'saveAnswer',
    /**
     * EmbedApi
     * @hidden
     */
    UIPassthrough = 'UiPassthrough',
    /**
     * Triggers the table visualization re-render with the updated data.
     * Includes the following properties:
     * @param - `columnDataLite` - an array of object containing the
     * data value modifications retrieved from the `EmbedEvent.TableVizRendered`
     * payload.For example, { columnDataLite: []}`.
     *
     * @example
     * ```js
     * searchEmbed.on(EmbedEvent.TableVizRendered, (payload) => {
     *      console.log(payload);
     *      const columnDataLite = payload.data.data.columnDataLite;
     *      columnDataLite[0].dataValue[0]="new fob";
     *      console.log('>>> new Data', columnDataLite);
     *      searchEmbed.trigger(HostEvent.TransformTableVizData, columnDataLite);
     * })
     * ```
     * @version SDK: 1.37.0 | ThoughtSpot: 10.8.0.cl
     */
    TransformTableVizData = 'TransformTableVizData',
    /**
     * Triggers a search operation with the search tokens specified in
     * the search query string in spotter embed.
     * Payload: {@link SpotterSearchRequest}.
     * @param - Includes the following keys:
     * - `query`: Text string in Natural Language format.
     * - `executeSearch`: Boolean to execute search and update search query.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.SpotterSearch, {
     *  query: 'revenue per year',
     *  executeSearch: true,
     * })
     * ```
     * @example
     * ```js
     * // Spotter search from spotter context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * spotterEmbed.trigger(HostEvent.SpotterSearch, {
     *     query: 'sales by region',
     *     executeSearch: true
     * }, ContextType.Spotter);
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    SpotterSearch = 'SpotterSearch',
    /**
     * Edits the last prompt in spotter embed.
     * Payload: `string`.
     * @param - `query`: Text string
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.EditLastPrompt, "revenue per year");
     * ```
     * @example
     * ```js
     * // Edit last prompt from spotter context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * spotterEmbed.trigger(HostEvent.EditLastPrompt, "sales by region", ContextType.Spotter);
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    EditLastPrompt = 'EditLastPrompt',
    /**
     * Opens the data source preview modal in Spotter Embed.
     * Payload: none.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.PreviewSpotterData);
     * ```
     * @example
     * ```js
     * // Preview spotter data from spotter context
     * import { ContextType } from '@thoughtspot/visual-embed-sdk';
     * spotterEmbed.trigger(HostEvent.PreviewSpotterData, {}, ContextType.Spotter);
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    PreviewSpotterData = 'PreviewSpotterData',
    /**
     * Opens the Add to Coaching modal from a visualization in Spotter Embed.
     * @param - `vizId ` refers to the Visualization ID in Spotter embed and is required.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.AddToCoaching, { vizId: '730496d6-6903-4601-937e-2c691821af3c' });
     *
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     */
    AddToCoaching = 'addToCoaching',
    /**
     * Opens the data model instructions modal in Spotter Embed.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.DataModelInstructions);
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot: 26.3.0.cl
     */
    DataModelInstructions = 'DataModelInstructions',
    /**
     * Resets the Spotter Embed Conversation.
     * Payload: none.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.ResetSpotterConversation);
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    ResetSpotterConversation = 'ResetSpotterConversation',
    /**
     * Opens the Spotter share-conversation modal for the given conversation.
     * `conversationId` is **mandatory** — you must pass the id of the
     * conversation to share. Also no-op when sharing is disabled
     * (enableShareConversation off) or when already in the read-only shared view.
     * Payload: {@link ConversationScopedRequest}.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.ShareSpotterConversation, { conversationId: 'abc' });
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    ShareSpotterConversation = 'ShareSpotterConversation',
    /**
     * Closes the Spotter share-conversation modal. No-op if none is open.
     * Payload: none.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.CloseSpotterShareConversation);
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    CloseSpotterShareConversation = 'CloseSpotterShareConversation',
    /**
     * Exits the read-only shared-conversation view.
     * Payload: none.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.ExitSpotterSharedConversation);
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    ExitSpotterSharedConversation = 'ExitSpotterSharedConversation',
    /**
     * Deletes the last prompt in spotter embed.
     * Payload: none.
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.DeleteLastPrompt);
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    DeleteLastPrompt = 'DeleteLastPrompt',
    /**
     * Toggle the visualization to chart or table view.
     * Payload: {@link RequiredVizRequest}.
     * @param - `vizId ` refers to the Visualization ID in Spotter embed and is required.
     * @example
     * ```js
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.AnswerChartSwitcher, { vizId: latestSpotterVizId });
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    AnswerChartSwitcher = 'answerChartSwitcher',
    /**
     * @hidden
     * Trigger exit from presentation mode when user exits fullscreen.
     * This is automatically triggered by the SDK when fullscreen mode is exited.
     * ```js
     * liveboardEmbed.trigger(HostEvent.ExitPresentMode);
     * ```
     * @version SDK: 1.40.0 | ThoughtSpot: 10.11.0.cl
     */
    ExitPresentMode = 'exitPresentMode',
    /**
     * Triggers the full height lazy load data.
     * @example
     * ```js
     * liveboardEmbed.on(EmbedEvent.RequestVisibleEmbedCoordinates, (payload) => {
     *      console.log(payload);
     * });
     * ```
     * @version SDK: 1.39.0 | ThoughtSpot: 10.10.0.cl
     *
     * @hidden
     */
    VisibleEmbedCoordinates = 'visibleEmbedCoordinates',
    /**
     * Trigger the *Spotter* action for visualizations present on the liveboard's vizzes.
     * Payload: {@link RequiredVizRequest}.
     * @param - `vizId` refers to the Visualization ID in Spotter embed and is required.
     * @example
     * ```js
     * let latestSpotterVizId = '';
     * spotterEmbed.on(EmbedEvent.Data, (payload) => {
     *   latestSpotterVizId = payload.data.id;
     * });
     *
     * spotterEmbed.trigger(HostEvent.AskSpotter, { vizId: latestSpotterVizId });
     * ```
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     */
    AskSpotter = 'AskSpotter',

    /**
     * @hidden
     * Triggers the update of the embed params.
     *
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.UpdateEmbedParams, viewConfig);
     * ```
     */
    UpdateEmbedParams = 'updateEmbedParams',
    /**
     * Notifies the embedded ThoughtSpot app that the embed is being torn down, so that
     * it can release any resources it holds before the iframe is removed from the DOM.
     *
     * This is triggered for you by `embed.destroy()`; you rarely need to trigger it
     * directly. If `waitForCleanupOnDestroy` is set in the embed config, `destroy()`
     * waits for the app to acknowledge this event (up to `cleanupTimeout`) before
     * removing the iframe.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.DestroyEmbed);
     * ```
     * @version SDK: 1.41.0 | ThoughtSpot: 10.12.0.cl
     */
    DestroyEmbed = 'EmbedDestroyed',
    /**
     * Triggers a new conversation in Spotter embed.
     *
     * This feature is available only when chat history is enabled on your ThoughtSpot
     * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
     * instance.
     *
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.StartNewSpotterConversation);
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     */
    StartNewSpotterConversation = 'StartNewSpotterConversation',

    /**
     * Pins a saved Spotter conversation so it floats to the top of the past
     * conversations sidebar. The `conversationId` of the conversation to pin is
     * required.
     *
     * This feature is available only when chat history is enabled on your ThoughtSpot
     * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
     * instance.
     *
     * Payload: {@link ConversationScopedRequest}.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.PinSpotterConversation, {
     *     conversationId: '<conversation-id>',
     * });
     * ```
     */
    PinSpotterConversation = 'PinSpotterConversation',

    /**
     * Unpins a previously pinned Spotter conversation. The `conversationId` of the
     * conversation to unpin is required.
     *
     * This feature is available only when chat history is enabled on your ThoughtSpot
     * instance. Contact your admin or ThoughtSpot Support to enable chat history on your
     * instance.
     *
     * Payload: {@link ConversationScopedRequest}.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * spotterEmbed.trigger(HostEvent.UnpinSpotterConversation, {
     *     conversationId: '<conversation-id>',
     * });
     * ```
     */
    UnpinSpotterConversation = 'UnpinSpotterConversation',

    /**
     * @hidden
     * Get the current context of the embedded page.
     *
     * @example
     * ```js
     * const context = await liveboardEmbed.trigger(HostEvent.GetPageContext);
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot: 26.2.0.cl
     */
    GetPageContext = 'GetPageContext',
    /**
     * Trigger the **Send Test Email** action in the Liveboard schedule modal.
     * Sends a test schedule email to self or all recipients.
     * Requires `isSendNowLiveboardSchedulingEnabled` to be enabled.
     * Payload: {@link ScheduleEmailRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SendTestScheduleEmail, {
     *     sendToSelf: true,
     * })
     * ```
     * @example
     * ```js
     * // Send to all recipients
     * liveboardEmbed.trigger(HostEvent.SendTestScheduleEmail, {
     *     sendToSelf: false,
     * })
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
     */
    SendTestScheduleEmail = 'sendTestScheduleEmail',

    /**
     * Sends a user message (prompt) to the SpotterViz panel programmatically.
     * Payload: `{ query: string }`.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @param query - the prompt text to send.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.SpotterVizSendUserMessage, {
     *     query: 'Show me revenue by region',
     * });
     * ```
     */
    SpotterVizSendUserMessage = 'SpotterVizSendUserMessage',

    /**
     * Initializes a new SpotterViz conversation.
     * Payload: none.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.InitSpotterVizConversation);
     * ```
     */
    InitSpotterVizConversation = 'InitSpotterVizConversation',

    /**
     * Opens the SpotterViz panel.
     * Payload: none.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.OpenSpotterVizPanel);
     * ```
     */
    OpenSpotterVizPanel = 'OpenSpotterVizPanel',

    /**
     * Closes the SpotterViz panel.
     * Payload: none.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.CloseSpotterVizPanel);
     * ```
     */
    CloseSpotterVizPanel = 'CloseSpotterVizPanel',

    /**
     * Clears browser cache and fetches new data for liveboard ChartViz Containers.
     * Requires `enableLiveboardDataCache` to be enabled.
     * Payload: {@link ScheduleEmailRequest}.
     * @example
     * ```js
     * liveboardEmbed.trigger(HostEvent.RefreshLiveboardBrowserCache);
     * ```
     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
     */
    RefreshLiveboardBrowserCache = 'refreshLiveboardBrowserCache',
}

/**
 * The different visual modes that the data sources panel within
 * search could appear in, such as hidden, collapsed, or expanded.
 */

export enum DataSourceVisualMode {
    /**
     * The data source panel is hidden.
     */
    Hidden = 'hide',
    /**
     * The data source panel is collapsed, but the user can manually expand it.
     */
    Collapsed = 'collapse',
    /**
     * The data source panel is expanded, but the user can manually collapse it.
     */
    Expanded = 'expand',
}

/**
 * The query params passed down to the embedded ThoughtSpot app
 * containing configuration and/or visual information.
 */

export enum Param {
    Tsmcp = 'tsmcp',
    EmbedApp = 'embedApp',
    DataSources = 'dataSources',
    DataSourceMode = 'dataSourceMode',
    DisableActions = 'disableAction',
    DisableActionReason = 'disableHint',
    ForceTable = 'forceTable',
    preventLiveboardFilterRemoval = 'preventPinboardFilterRemoval', // update-TSCB
    SearchQuery = 'searchQuery',
    HideActions = 'hideAction',
    HideObjects = 'hideObjects',
    HostAppUrl = 'hostAppUrl',
    EnableVizTransformations = 'enableVizTransform',
    EnableSearchAssist = 'enableSearchAssist',
    EnableConnectionNewExperience = 'newConnectionsExperience',
    EnablePendoHelp = 'enablePendoHelp',
    HideResult = 'hideResult',
    UseLastSelectedDataSource = 'useLastSelectedSources',
    Tag = 'tag',
    HideTagFilterChips = 'hideTagFilterChips',
    AutoLogin = 'autoLogin',
    searchTokenString = 'searchTokenString',
    executeSearch = 'executeSearch',
    fullHeight = 'isFullHeightPinboard',
    livedBoardEmbed = 'isLiveboardEmbed',
    searchEmbed = 'isSearchEmbed',
    vizEmbed = 'isVizEmbed',
    StringIDsUrl = 'overrideStringIDsUrl',
    Version = 'sdkVersion',
    ViewPortHeight = 'viewPortHeight',
    ViewPortWidth = 'viewPortWidth',
    VisibleActions = 'visibleAction',
    DisableLoginRedirect = 'disableLoginRedirect',
    visibleVizs = 'pinboardVisibleVizs',
    LiveboardV2Enabled = 'isPinboardV2Enabled',
    DataPanelV2Enabled = 'enableDataPanelV2',
    ShowAlerts = 'showAlerts',
    Locale = 'locale',
    CustomStyle = 'customStyle',
    ForceSAMLAutoRedirect = 'forceSAMLAutoRedirect',
    // eslint-disable-next-line @typescript-eslint/no-shadow
    AuthType = 'authType',
    IconSpriteUrl = 'iconSprite',
    cookieless = 'cookieless',
    // Deprecated: `isContextMenuEnabledOnLeftClick`
    // Introduced: `contextMenuEnabledOnWhichClick` with values: 'left',
    // 'right', or 'both'. This update only affects ThoughtSpot URL parameters
    // and does not impact existing workflows or use cases. Added support for
    // 'both' clicks in `contextMenuTrigger` configuration.
    ContextMenuTrigger = 'contextMenuEnabledOnWhichClick',
    LinkOverride = 'linkOverride',
    EnableLinkOverridesV2 = 'enableLinkOverridesV2',
    blockNonEmbedFullAppAccess = 'blockNonEmbedFullAppAccess',
    ShowInsertToSlide = 'insertInToSlide',
    PrimaryNavHidden = 'primaryNavHidden',
    HideProfleAndHelp = 'profileAndHelpInNavBarHidden',
    NavigationVersion = 'navigationVersion',
    HideHamburger = 'hideHamburger',
    HideObjectSearch = 'hideObjectSearch',
    HideNotification = 'hideNotification',
    HideApplicationSwitcher = 'applicationSwitcherHidden',
    HideOrgSwitcher = 'orgSwitcherHidden',
    HideWorksheetSelector = 'hideWorksheetSelector',
    DisableWorksheetChange = 'disableWorksheetChange',
    HideSourceSelection = 'hideSourceSelection',
    DisableSourceSelection = 'disableSourceSelection',
    HideEurekaResults = 'hideEurekaResults',
    HideEurekaSuggestions = 'hideEurekaSuggestions',
    HideAutocompleteSuggestions = 'hideAutocompleteSuggestions',
    HideLiveboardHeader = 'hideLiveboardHeader',
    ShowLiveboardDescription = 'showLiveboardDescription',
    ShowLiveboardTitle = 'showLiveboardTitle',
    ShowMaskedFilterChip = 'showMaskedFilterChip',
    IsLiveboardMasterpiecesEnabled = 'isLiveboardMasterpiecesEnabled',
    EnableNewChartLibrary = 'muzeChartPhase1EnabledGA',
    HiddenTabs = 'hideTabs',
    VisibleTabs = 'visibleTabs',
    HideTabPanel = 'hideTabPanel',
    HideSampleQuestions = 'hideSampleQuestions',
    WorksheetId = 'worksheet',
    Query = 'query',
    HideHomepageLeftNav = 'hideHomepageLeftNav',
    ModularHomeExperienceEnabled = 'modularHomeExperience',
    HomepageVersion = 'homepageVersion',
    ListPageVersion = 'listpageVersion',
    PendoTrackingKey = 'additionalPendoKey',
    LiveboardHeaderSticky = 'isLiveboardHeaderSticky',
    IsProductTour = 'isProductTour',
    HideSearchBarTitle = 'hideSearchBarTitle',
    HideSageAnswerHeader = 'hideSageAnswerHeader',
    HideSearchBar = 'hideSearchBar',
    ClientLogLevel = 'clientLogLevel',
    ExposeTranslationIDs = 'exposeTranslationIDs',
    OverrideNativeConsole = 'overrideConsoleLogs',
    enableAskSage = 'enableAskSage',
    CollapseSearchBarInitially = 'collapseSearchBarInitially',
    DataPanelCustomGroupsAccordionInitialState = 'dataPanelCustomGroupsAccordionInitialState',
    EnableCustomColumnGroups = 'enableCustomColumnGroups',
    DateFormatLocale = 'dateFormatLocale',
    NumberFormatLocale = 'numberFormatLocale',
    CurrencyFormat = 'currencyFormat',
    Enable2ColumnLayout = 'enable2ColumnLayout',
    IsLiveboardAlwaysOn12ColLayout = 'isLiveboardAlwaysOn12ColLayout',
    IsFullAppEmbed = 'isFullAppEmbed',
    IsOnBeforeGetVizDataInterceptEnabled = 'isOnBeforeGetVizDataInterceptEnabled',
    FocusSearchBarOnRender = 'focusSearchBarOnRender',
    DisableRedirectionLinksInNewTab = 'disableRedirectionLinksInNewTab',
    HomePageSearchBarMode = 'homePageSearchBarMode',
    ShowLiveboardVerifiedBadge = 'showLiveboardVerifiedBadge',
    ShowLiveboardReverifyBanner = 'showLiveboardReverifyBanner',
    LiveboardHeaderV2 = 'isLiveboardHeaderV2Enabled',
    HideIrrelevantFiltersInTab = 'hideIrrelevantFiltersAtTabLevel',
    IsEnhancedFilterInteractivityEnabled = 'isLiveboardPermissionV2Enabled',
    SpotterEnabled = 'isSpotterExperienceEnabled',
    IsUnifiedSearchExperienceEnabled = 'isUnifiedSearchExperienceEnabled',
    OverrideOrgId = 'orgId',
    OverrideHistoryState = 'overrideHistoryState',
    OauthPollingInterval = 'oAuthPollingInterval',
    IsForceRedirect = 'isForceRedirect',
    DataSourceId = 'dataSourceId',
    preAuthCache = 'preAuthCache',
    ShowSpotterLimitations = 'showSpotterLimitations',
    CoverAndFilterOptionInPDF = 'arePdfCoverFilterPageCheckboxesEnabled',
    PrimaryAction = 'primaryAction',
    isSpotterAgentEmbed = 'isSpotterAgentEmbed',
    IsLiveboardStylingAndGroupingEnabled = 'isLiveboardStylingAndGroupingEnabled',
    LiveboardGutter = 'liveboardGutter',
    IsLazyLoadingForEmbedEnabled = 'isLazyLoadingForEmbedEnabled',
    RootMarginForLazyLoad = 'rootMarginForLazyLoad',
    isPNGInScheduledEmailsEnabled = 'isPNGInScheduledEmailsEnabled',
    IsWYSIWYGLiveboardPDFEnabled = 'isWYSIWYGLiveboardPDFEnabled',
    isLiveboardXLSXCSVDownloadEnabled = 'isLiveboardXLSXCSVDownloadEnabled',
    isGranularXLSXCSVSchedulesEnabled = 'isGranularXLSXCSVSchedulesEnabled',
    isSendNowLiveboardSchedulingEnabled = 'isSendNowLiveboardSchedulingEnabled',
    isCentralizedLiveboardFilterUXEnabled = 'isCentralizedLiveboardFilterUXEnabled',
    isScopedLiveboardFilteringEnabled = 'isScopedLiveboardFilteringEnabled',
    isLinkParametersEnabled = 'isLinkParametersEnabled',
    EnablePastConversationsSidebar = 'enablePastConversationsSidebar',
    UpdatedSpotterChatPrompt = 'updatedSpotterChatPrompt',
    ShowSpotterRadiance = 'showSpotterRadiance',
    DefaultQueryMode = 'defaultQueryMode',
    EnableStopAnswerGenerationEmbed = 'enableStopAnswerGenerationEmbed',
    SpotterSidebarTitle = 'spotterSidebarTitle',
    SpotterSidebarDefaultExpanded = 'spotterSidebarDefaultExpanded',
    SpotterChatRenameLabel = 'spotterChatRenameLabel',
    SpotterChatDeleteLabel = 'spotterChatDeleteLabel',
    SpotterDeleteConversationModalTitle = 'spotterDeleteConversationModalTitle',
    SpotterPastConversationAlertMessage = 'spotterPastConversationAlertMessage',
    SpotterDocumentationUrl = 'spotterDocumentationUrl',
    SpotterBestPracticesLabel = 'spotterBestPracticesLabel',
    SpotterConversationsBatchSize = 'spotterConversationsBatchSize',
    SpotterNewChatButtonTitle = 'spotterNewChatButtonTitle',
    IsThisPeriodInDateFiltersEnabled = 'isThisPeriodInDateFiltersEnabled',
    HideToolResponseCardBranding = 'hideToolResponseCardBranding',
    ToolResponseCardBrandingLabel = 'toolResponseCardBrandingLabel',
    EnableHomepageAnnouncement = 'enableHomepageAnnouncement',
    EnableLiveboardDataCache = 'enableLiveboardDataCache',
    SpotterFileUploadEnabled = 'spotterFileUploadEnabled',
    SpotterFileUploadFileTypes = 'spotterFileUploadFileTypes',
    IsStarterPromptsEnabled = 'enableStarterPrompts',
    UpdatedSpotterExperience = 'updatedSpotterExperience',
    SpotterDataSources = 'spotterDataSources',
    AnalystId = 'analystId',
    OpenSpotterOnLiveboardByDefault = 'openSpotterOnLiveboardByDefault',
    ShowAnswerEditPanel = 'showAnswerEditPanel',
}

/**
 * Configuration for allowed file types in Spotter file upload.
 * @group Embed components
 */
export type SpotterFileUploadFileTypes = {
    types?: string[];
};

/**
 * ThoughtSpot application pages include actions and menu commands
 * for various user-initiated operations. These actions are represented
 * as enumeration members in the SDK. To control actions in the embedded view:
 * - disabledActions — the action is grayed out and still visible, but non-interactive
 * (user can see but not click). - hiddenActions — the action is completely removed from
 * the UI (user cannot see it at all). - visibleActions — allowlist, only these actions
 * are shown; all others are hidden.
 *
 * Use disabledActions to disable (gray out) an action.
 * Use hiddenActions to hide (fully remove) an action.
 * Use visibleActions to show only specific actions.
 * @example
 * ```js
 * const embed = new LiveboardEmbed('#tsEmbed', {
 *    ... //other embed view config
 *    visibleActions: [Action.Save, Action.Edit, Action.Present, Action.Explore],
 *    disabledActions: [Action.Download],
 *    //hiddenActions: [], // Set either this or visibleActions
 * })
 * ```
 * @example
 * ```js
 * const embed = new LiveboardEmbed('#tsEmbed', {
 *    ... //other embed view config
 *    //visibleActions: [],
 *    disabledActions: [Action.Download],
 *    hiddenActions: [Action.Edit, Action.Explore],
 * })
 * ```
 * See also link:https://developers.thoughtspot.com/docs/actions[Developer Documentation].
 */

export enum Action {
    /**
     * The **Save** action on an Answer or Liveboard.
     * Allows users to save the changes.
     * @example
     * ```js
     * disabledActions: [Action.Save]
     * ```
     */
    Save = 'save',
    /**
     * @hidden
     */
    Update = 'update',
    /**
     * @hidden
     */
    SaveUntitled = 'saveUntitled',
    /**
     * The **Save as View** action on the Answer
     * page. Saves an Answer as a View object in the full
     * application embedding mode.
     * @example
     * ```js
     * disabledActions: [Action.SaveAsView]
     * ```
     */
    SaveAsView = 'saveAsView',
    /**
     * The **EditInputTable** action on a Liveboard
     * page. Allows users to edit an input table used in an Answer directly from
     * a Liveboard.
     * @example
     * ```js
     * disabledActions: [Action.EditInputTable]
     * ```
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    EditInputTable = 'editInputTable',
    /**
     * The **Make a copy** action on a Liveboard 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
     * disabledActions: [Action.MakeACopy]
     * ```
     */
    MakeACopy = 'makeACopy',
    /**
     * The **Copy and Edit** action on a Liveboard.
     * This action is now replaced with `Action.MakeACopy`.
     * @example
     * ```js
     * disabledActions: [Action.EditACopy]
     * ```
     */
    EditACopy = 'editACopy',
    /**
     * The **Copy link** menu action on a Liveboard visualization.
     * Copies the visualization URL
     * @example
     * ```js
     * disabledActions: [Action.CopyLink]
     * ```
     */
    CopyLink = 'embedDocument',
    /**
     * @hidden
     */
    ResetLayout = 'resetLayout',
    /**
     * The **Schedule** menu action on a Liveboard.
     * Allows scheduling a Liveboard job, for example,
     * sending periodic notifications.
     * @example
     * ```js
     * disabledActions: [Action.Schedule]
     * ```
     */
    Schedule = 'subscription',
    /**
     * The **Manage schedules** menu action on a Liveboard.
     * Allows users to manage scheduled Liveboard jobs.
     * @example
     * ```js
     * disabledActions: [Action.SchedulesList]
     * ```
     */
    SchedulesList = 'schedule-list',
    /**
     * The **Share** action on a Liveboard, Answer, or Model.
     * Allows users to share an object with other users and groups.
     * @example
     * ```js
     * disabledActions: [Action.Share]
     * ```
     */
    Share = 'share',
    /**
     * The **Add filter** action on a Liveboard page.
     * Allows adding filters to visualizations on a Liveboard.
     * @example
     * ```js
     * disabledActions: [Action.AddFilter]
     * ```
     */
    AddFilter = 'addFilter',
    /**
     * The **Add Data Panel Objects** action on the data panel v2.
     * Allows to show action menu to add different objects (such as
     * formulas, Parameters) in data panel new experience.
     * @example
     * ```js
     * disabledActions: [Action.AddDataPanelObjects]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
     */
    AddDataPanelObjects = 'addDataPanelObjects',
    /**
     * The filter configuration options for a Liveboard.
     * The configuration options are available when adding
     * filters on a Liveboard.
     *
     * @example
     * ```js
     * disabledActions: [Action.ConfigureFilter]
     * ```
     */
    ConfigureFilter = 'configureFilter',
    /**
     * The **Collapse data sources** icon on the Search page.
     * Collapses the panel showing data sources.
     *
     * @example
     * ```js
     * disabledActions: [Action.CollapseDataPanel]
     * ```
     * @version SDK: 1.1.0 | ThoughtSpot Cloud: ts7.may.cl, 8.4.1.sw
     */
    CollapseDataSources = 'collapseDataSources',
    /**
     * The **Collapse data panel** icon on the Search page.
     * Collapses the data panel view.
     *
     * @version SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
     *
     * @example
     * ```js
     * disabledActions: [Action.CollapseDataPanel]
     * ```
     */
    CollapseDataPanel = 'collapseDataPanel',
    /**
     * The **Choose sources** button on Search page.
     * Allows selecting data sources for search queries.
     * @example
     * ```js
     * disabledActions: [Action.ChooseDataSources]
     * ```
     */
    ChooseDataSources = 'chooseDataSources',
    /**
     * The **Create formula** action on a Search or Answer page.
     * Allows adding formulas to an Answer.
     * @example
     * ```js
     * disabledActions: [Action.AddFormula]
     * ```
     */
    AddFormula = 'addFormula',
    /**
     * The **Add parameter** action on a Liveboard or Answer.
     * Allows adding Parameters to a Liveboard or Answer.
     * @example
     * ```js
     * disabledActions: [Action.AddParameter]
     * ```
     */
    AddParameter = 'addParameter',
    /**
     * The **Add Column Set** action on a Answer.
     * Allows adding column sets to a Answer.
     * @example
     * ```js
     * disabledActions: [Action.AddColumnSet]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
     */
    AddColumnSet = 'addSimpleCohort',
    /**
     * The **Add Query Set** action on a Answer.
     * Allows adding query sets to a Answer.
     * @example
     * ```js
     * disabledActions: [Action.AddQuerySet]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl, 10.1.0.sw
     */
    AddQuerySet = 'addAdvancedCohort',
    /**
     * @hidden
     */
    SearchOnTop = 'searchOnTop',
    /**
     * The **SpotIQ analyze** menu action on a visualization or
     * Answer page.
     * @example
     * ```js
     * disabledActions: [Action.SpotIQAnalyze]
     * ```
     */
    SpotIQAnalyze = 'spotIQAnalyze',
    /**
     * @hidden
     */
    ExplainInsight = 'explainInsight',
    /**
     * @hidden
     */
    SpotIQFollow = 'spotIQFollow',
    /**
     * The Share action for a Liveboard visualization.
     */
    ShareViz = 'shareViz',
    /**
     * @hidden
     */
    ReplaySearch = 'replaySearch',
    /**
     * The **Show underlying data** menu action on a
     * visualization or Answer page.
     * Displays detailed information and raw data
     * for a given visualization.
     * @example
     * ```js
     * disabledActions: [Action.ShowUnderlyingData]
     * ```
     */
    ShowUnderlyingData = 'showUnderlyingData',
    /**
     * The **Download** menu action on Liveboard
     * visualizations and Answers.
     * Allows downloading a visualization or Answer.
     * @example
     * ```js
     * disabledActions: [Action.DownloadAsPng]
     * ```
     */
    Download = 'download',
    /**
     * The **Download** > **PNG** menu action for charts on a Liveboard
     * or Answer page.
     * Downloads a visualization or Answer as a PNG file.
     * @example
     * ```js
     * disabledActions: [Action.DownloadAsPng]
     * ```
     */
    DownloadAsPng = 'downloadAsPng',
    /**
     *
     *The **Download PDF** action that downloads a Liveboard,
     * visualization, or Answer as a PDF file.
     *
     * **NOTE**: The **Download** > **PDF** option is available for
     * tables in visualizations and Answers.
     * @example
     * ```js
     * disabledActions: [Action.DownloadAsPdf]
     * ```
     */
    DownloadAsPdf = 'downloadAsPdf',
    /**
     * The **Download** > **CSV** menu action for tables on a Liveboard
     * or Answer page.
     * Downloads a visualization or Answer in the XLSX format.
     * @example
     * ```js
     * disabledActions: [Action.DownloadAsCsv]
     * ```
     */
    DownloadAsCsv = 'downloadAsCSV',
    /**
     * The **Download** > **XLSX** menu action for tables on a Liveboard
     * or Answer page.
     * Downloads a visualization or Answer in the XLSX format.
     * @example
     * ```js
     * disabledActions: [Action.DownloadAsXlsx]
     * ```
     */
    DownloadAsXlsx = 'downloadAsXLSX',
    /**
     * The **Download Liveboard** menu action on a Liveboard.
     * Allows downloading the entire Liveboard.
     * @example
     * ```js
     * disabledActions: [Action.DownloadLiveboard]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DownloadLiveboard = 'downloadLiveboard',
    /**
     * The **Download Liveboard as Continuous PDF** menu action on a Liveboard.
     * Allows downloading the entire Liveboard as a continuous PDF.
     * @example
     * ```js
     * disabledActions: [Action.DownloadLiveboardAsContinuousPDF]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DownloadLiveboardAsContinuousPDF = 'downloadLiveboardAsContinuousPDF',
    /**
     * The Download Liveboard as A4 PDF menu action on a Liveboard.
     * Allows downloading the entire Liveboard as an A4 PDF.
     * Requires {@link Action.DownloadLiveboard} as a parent action when
     * {@link LiveboardViewConfig.isLiveboardXLSXCSVDownloadEnabled} or
     * {@link LiveboardViewConfig.isContinuousLiveboardPDFEnabled} flags are enabled.
     * Use this instead of {@link Action.DownloadAsPdf} when either flag is on.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * disabledActions: [Action.DownloadLiveboardAsA4Pdf]
     * ```
     */
    DownloadLiveboardAsA4Pdf = 'downloadLiveboardAsA4Pdf',
    /**
     * The **Download Liveboard as XLSX** menu action on a Liveboard.
     * Allows downloading the entire Liveboard as an XLSX file.
     * @example
     * ```js
     * disabledActions: [Action.DownloadLiveboardAsXlsx]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DownloadLiveboardAsXlsx = 'downloadLiveboardAsXlsx',
    /**
     * The **Download Liveboard as CSV** menu action on a Liveboard.
     * Allows downloading the entire Liveboard as a CSV file.
     * @example
     * ```js
     * disabledActions: [Action.DownloadLiveboardAsCsv]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    DownloadLiveboardAsCsv = 'downloadLiveboardAsCsv',
    /**
     * @hidden
     */
    DownloadTrace = 'downloadTrace',
    /**
     * The **Export TML** menu action on a Liveboard, Answer, and
     * the Data Workspace pages for data objects and connections.
     *
     * Allows exporting an object as a TML file.
     *
     * @example
     * ```js
     * disabledActions: [Action.ExportTML]
     * ```
     */
    ExportTML = 'exportTSL',
    /**
     * The **Import TML** menu action on the
     * *Data Workspace* > *Utilities* page.
     * Imports TML representation of ThoughtSpot objects.
     * @example
     * ```js
     * disabledActions: [Action.ImportTML]
     * ```
     */
    ImportTML = 'importTSL',
    /**
     * The **Update TML** menu action for Liveboards and Answers.
     * Updates TML representation of ThoughtSpot objects.
     * @example
     * ```js
     * disabledActions: [Action.UpdateTML]
     * ```
     */
    UpdateTML = 'updateTSL',
    /**
     * The **Edit TML** menu action for Liveboards and Answers.
     * Opens the TML editor.
     * @example
     * ```js
     * disabledActions: [Action.EditTML]
     * ```
     */
    EditTML = 'editTSL',
    /**
     * The **Present** menu action for Liveboards and Answers.
     * Allows presenting a Liveboard or visualization in
     * slideshow mode.
     * @example
     * ```js
     * disabledActions: [Action.Present]
     * ```
     */
    Present = 'present',
    /**
     * The visualization tile resize option.
     * Also available via More `...` options menu on a visualization.
     * Allows resizing visualization tiles and switching
     * between different preset layout option.
     *
     * @example
     * ```js
     * disabledActions: [Action.ToggleSize]
     * ```
     */
    ToggleSize = 'toggleSize',
    /**
     * The *Edit* action on the Liveboard page and in the
     * visualization menu.
     * Opens a Liveboard or visualization in edit mode.
     * @example
     * ```js
     * disabledActions: [Action.Edit]
     * ```
     */
    Edit = 'edit',
    /**
     * The text edit option for Liveboard and visualization titles.
     * @example
     * ```js
     * disabledActions: [Action.EditTitle]
     * ```
     */
    EditTitle = 'editTitle',
    /**
     * The **Delete** action on a Liveboard, *Liveboards* and
     * *Answers* list pages in full application embedding.
     *
     * @example
     * ```js
     * disabledActions: [Action.Remove]
     * ```
     */
    Remove = 'delete',
    /**
     * @hidden
     */
    Ungroup = 'ungroup',
    /**
     * @hidden
     */
    Describe = 'describe',
    /**
     * @hidden
     */
    Relate = 'relate',
    /**
     * @hidden
     */
    CustomizeHeadlines = 'customizeHeadlines',
    /**
     * @hidden
     */
    PinboardInfo = 'pinboardInfo',
    /**
     * The **Show Liveboard details** menu action on a Liveboard.
     * Displays details such as the name, description, and
     * author of the Liveboard, and timestamp of Liveboard creation
     * and update.
     * @example
     * ```js
     * disabledActions: [Action.LiveboardInfo]
     * ```
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    LiveboardInfo = 'pinboardInfo',
    /**
     * @hidden
     */
    SendAnswerFeedback = 'sendFeedback',
    /**
     * @hidden
     */
    DownloadEmbraceQueries = 'downloadEmbraceQueries',
    /**
     * The **Pin** menu action on an Answer or
     * Search results page.
     * @example
     * ```js
     * disabledActions: [Action.Pin]
     * ```
     */
    Pin = 'pin',
    /**
     * @hidden
     */
    AnalysisInfo = 'analysisInfo',
    /**
     * The **Schedule** menu action on a Liveboard.
     * Allows scheduling a Liveboard job.
     * @example
     * ```js
     * disabledActions: [Action.Subscription]
     * ```
     */
    // eslint-disable-next-line @typescript-eslint/no-duplicate-enum-values
    Subscription = 'subscription',
    /**
     * The **Explore** action on Liveboard visualizations
     * @example
     * ```js
     * disabledActions: [Action.Explore]
     * ```
     */
    Explore = 'explore',
    /**
     * The contextual menu action to include a specific data point
     * when drilling down a table or chart on an Answer.
     *
     * @example
     * ```js
     * disabledActions: [Action.DrillInclude]
     * ```
     */

    DrillInclude = 'context-menu-item-include',
    /**
     * The contextual menu action to exclude a specific data point
     * when drilling down a table or chart on an Answer.
     * @example
     * ```js
     * disabledActions: [Action.DrillInclude]
     * ```
     */
    DrillExclude = 'context-menu-item-exclude',
    /**
     * The **Copy to clipboard** menu action on tables in an Answer
     * or Liveboard.
     * Copies the selected data point.
     * @example
     * ```js
     * disabledActions: [Action.CopyToClipboard]
     * ```
     */
    CopyToClipboard = 'context-menu-item-copy-to-clipboard',
    CopyAndEdit = 'context-menu-item-copy-and-edit',
    /**
     * @hidden
     */
    DrillEdit = 'context-menu-item-edit',
    EditMeasure = 'context-menu-item-edit-measure',
    Separator = 'context-menu-item-separator',
    /**
     * The **Drill down** menu action on Answers and Liveboard
     * visualizations.
     * Allows drilling down to a specific data point on a chart or table.
     * @example
     * ```js
     * disabledActions: [Action.DrillDown]
     * ```
     */
    DrillDown = 'DRILL',
    /**
     * The request access action on Liveboards.
     * Allows users with view permissions to request edit access to a Liveboard.
     * @example
     * ```js
     * disabledActions: [Action.RequestAccess]
     * ```
     */
    RequestAccess = 'requestAccess',
    /**
     * Controls the display and availability of the **Query visualizer** and
     * **Query SQL** buttons in the Query details panel on the Answer page.
     *
     * **Query visualizer** - Displays the tables and filters used in the search query.
     * **Query SQL** - Displays the SQL statements used to retrieve data for the query.
     *
     * Note: This action ID only affects the visibility of the buttons within the
     * Query details panel. It does not control the visibility
     * of the query details icon on the Answer page.
     * @example
     * ```js
     * disabledActions: [Action.QueryDetailsButtons]
     * ```
     */
    QueryDetailsButtons = 'queryDetailsButtons',
    /**
     * The **Delete** action for Answers in the full application
     * embedding mode.
     * @example
     * ```js
     * disabledActions: [Action.AnswerDelete]
     * ```
     * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     */
    AnswerDelete = 'onDeleteAnswer',
    /**
     * The chart switcher icon on Answer page and
     * visualizations in edit mode.
     * Allows switching to the table or chart mode
     * when editing a visualization.
     * @example
     * ```js
     * disabledActions: [Action.AnswerChartSwitcher]
     * ```
     * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     */
    AnswerChartSwitcher = 'answerChartSwitcher',
    /**
     * The Favorites icon (*) for Answers,
     * Liveboard, and data objects like Model,
     * Tables and Views.
     * Allows adding an object to the user's favorites list.
     * @example
     * ```js
     * disabledActions: [Action.AddToFavorites]
     * ```
     * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     */
    AddToFavorites = 'addToFavorites',
    /**
     * Remove from Favorites option in home page v3 sidebar.
     * Allows removing an object from the user's favorites list from home-page v3 sidebar.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * disabledActions: [Action.RemoveFromFavorites]
     * ```
     */
    RemoveFromFavorites = 'removeFromFavorites',
    /**
     * The edit icon on Liveboards (Classic experience).
     * @example
     * ```js
     * disabledActions: [Action.EditDetails]
     * ```
     * @version SDK: 1.9.0 | ThoughtSpot: 8.1.0.cl, 8.4.1.sw
     */
    EditDetails = 'editDetails',
    /**
     * The *Create alert* action for KPI charts.
     * Allows users to schedule threshold-based alerts
     * for KPI charts.
     * @example
     * ```js
     * disabledActions: [Action.CreateMonitor]
     * ```
     * @version SDK: 1.11.0 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     */
    CreateMonitor = 'createMonitor',
    /**
     * @version SDK: 1.11.1 | ThoughtSpot: 8.3.0.cl, 8.4.1.sw
     * @deprecated This action is deprecated. It was used for reporting errors.
     * @example
     * ```js
     * disabledActions: [Action.ReportError]
     * ```
     */
    ReportError = 'reportError',
    /**
     * The **Sync to sheets** action on Answers and Liveboard visualizations.
     * Allows sending data to a Google Sheet.
     * @example
     * ```js
     * disabledActions: [Action.SyncToSheets]
     * ```
     * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
     */
    SyncToSheets = 'sync-to-sheets',
    /**
     * The **Sync to other apps** action on Answers and Liveboard visualizations.
     * Allows sending data to third-party apps like Slack, Salesforce,
     * Microsoft Teams, and so on.
     * @example
     * ```js
     * disabledActions: [Action.SyncToOtherApps]
     * ```
     * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
     */
    SyncToOtherApps = 'sync-to-other-apps',
    /**
     * The **Manage pipelines** action on Answers and Liveboard visualizations.
     * Allows users to manage data sync pipelines to third-party apps.
     * @example
     * ```js
     * disabledActions: [Action.ManagePipelines]
     * ```
     * @version SDK: 1.18.0 | ThoughtSpot: 8.10.0.cl, 9.0.1.sw
     */
    ManagePipelines = 'manage-pipeline',
    /**
     * The **Filter** action on Liveboard visualizations.
     * Allows users to apply cross-filters on a Liveboard.
     * @example
     * ```js
     * disabledActions: [Action.CrossFilter]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.8.0.sw
     */
    CrossFilter = 'context-menu-item-cross-filter',
    /**
     * The **Sync to Slack** action on Liveboard visualizations.
     * Allows sending data to third-party apps like Slack.
     * @example
     * ```js
     * disabledActions: [Action.SyncToSlack]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot Cloud: 10.1.0.cl
     */
    SyncToSlack = 'syncToSlack',
    /**
     * The **Sync to Teams** action on Liveboard visualizations.
     * Allows sending data to third-party apps like Microsoft Teams.
     * @example
     * ```js
     * disabledActions: [Action.SyncToTeams]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot Cloud: 10.1.0.cl
     */
    SyncToTeams = 'syncToTeams',
    /**
     * The **Remove** action that appears when cross filters are applied
     * on a Liveboard.
     * Removes filters applied to a visualization.
     * @example
     * ```js
     * disabledActions: [Action.RemoveCrossFilter]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    RemoveCrossFilter = 'context-menu-item-remove-cross-filter',
    /**
     * The **Aggregate** option in the chart axis or the
     * table column customization menu.
     * Provides aggregation options to analyze the data on a chart or table.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuAggregate]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuAggregate = 'axisMenuAggregate',
    /**
     * The **Time bucket** option in the chart axis or table column
     * customization menu.
     * Allows defining time metric for date comparison.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuTimeBucket]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuTimeBucket = 'axisMenuTimeBucket',
    /**
     * The **Filter** action in the chart axis or table column
     * customization menu.
     * Allows adding, editing, or removing filters.
     *
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuFilter]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuFilter = 'axisMenuFilter',
    /**
     * The **Conditional formatting** action on chart or table.
     * Allows adding rules for conditional formatting of data
     * points on a chart or table.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuConditionalFormat]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuConditionalFormat = 'axisMenuConditionalFormat',
    /**
     * The **Sort** menu action on a table or chart axis
     * Sorts data in ascending or descending order.
     * Allows adding, editing, or removing filters.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuConditionalFormat]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuSort = 'axisMenuSort',
    /**
     * The **Group** option in the chart axis or table column
     * customization menu.
     * Allows grouping data points if the axes use the same
     * unit of measurement and a similar scale.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuGroup]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuGroup = 'axisMenuGroup',
    /**
     * The **Position** option in the axis customization menu.
     * Allows changing the position of the axis to the
     * left or right side of the chart.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuPosition]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuPosition = 'axisMenuPosition',
    /**
     * The **Rename** option in the chart axis or table column customization menu.
     * Renames the axis label on a chart or the column header on a table.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuRename]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuRename = 'axisMenuRename',
    /**
     * The **Edit** action in the axis customization menu.
     * Allows editing the axis name, position, minimum and maximum values,
     * and format of a column.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuEdit]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuEdit = 'axisMenuEdit',
    /**
     * The **Number format** action to customize the format of
     * the data labels on a chart or table.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuNumberFormat]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuNumberFormat = 'axisMenuNumberFormat',
    /**
     * The **Text wrapping** action on a table.
     * Wraps or clips column text on a table.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuTextWrapping]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuTextWrapping = 'axisMenuTextWrapping',
    /**
     * The **Remove** action in the chart axis or table column
     * customization menu.
     * Removes the data labels from a chart or the column of a
     * table visualization.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuRemove]
     * ```
     * @version SDK: 1.21.0 | ThoughtSpot: 9.2.0.cl, 9.5.1.sw
     */
    AxisMenuRemove = 'axisMenuRemove',
    /**
     * The **Compare with** action in the chart axis customization menu.
     * Allows comparing data across dimensions or measures.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuCompare]
     * ```
     * @version SDK: 1.50.0 | ThoughtSpot: 26.7.0.cl
     */
    AxisMenuCompare = 'axisMenuCompare',
    /**
     * The **Merge with** action in the chart axis customization menu.
     * Allows merging data across dimensions or measures.
     * @example
     * ```js
     * disabledActions: [Action.AxisMenuMerge]
     * ```
     * @version SDK: 1.50.0 | ThoughtSpot: 26.7.0.cl
     */
    AxisMenuMerge = 'axisMenuMerge',
    /**
     * @hidden
     */
    InsertInToSlide = 'insertInToSlide',
    /**
     * The **Rename** menu action on Liveboards and visualizations.
     * Allows renaming a Liveboard or visualization.
     * @example
     * ```js
     * disabledActions: [Action.RenameModalTitleDescription]
     * ```
     * @version SDK: 1.23.0 | ThoughtSpot: 9.4.0.cl, 9.8.0.sw
     */
    RenameModalTitleDescription = 'renameModalTitleDescription',
    /**
     * The *Request verification* action on a Liveboard.
     * Initiates a request for Liveboard verification.
     * @example
     * ```js
     * disabledActions: [Action.RequestVerification]
     * ```
     * @version SDK: 1.25.0 | ThoughtSpot: 9.6.0.cl, 10.1.0.sw
     */
    RequestVerification = 'requestVerification',
    /**
     *
     * Allows users to mark a Liveboard as verified.
     * @example
     * ```js
     * disabledActions: [Action.MarkAsVerified]
     * ```
     * @version SDK: 1.25.0 | ThoughtSpot: 9.6.0.cl, 10.1.0.sw
     */
    MarkAsVerified = 'markAsVerified',
    /**
     * The **Add Tab** action on a Liveboard.
     * Allows adding a new tab to a Liveboard view.
     * @example
     * ```js
     * disabledActions: [Action.AddTab]
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 9.8.0.sw
     */
    AddTab = 'addTab',
    /**
     *
     * Initiates contextual change analysis on KPI charts.
     * @example
     * ```js
     * disabledActions: [Action.EnableContextualChangeAnalysis]
     * ```
     * @version SDK: 1.25.0 | ThoughtSpot Cloud: 9.6.0.cl
     */
    EnableContextualChangeAnalysis = 'enableContextualChangeAnalysis',
    /**
     * Action ID to hide or disable Iterative Change Analysis option
     * in the contextual change analysis Insight charts context menu.
     *
     * @example
     * ```js
     * disabledActions: [Action.EnableIterativeChangeAnalysis]
     * ```
     * @version SDK: 1.41.0 | ThoughtSpot Cloud: 9.12.0.cl
     */
    EnableIterativeChangeAnalysis = 'enableIterativeChangeAnalysis',
    /**
     * Action ID to hide or disable Natural Language Search query.
     *
     * @example
     * ```js
     * disabledActions: [Action.ShowSageQuery]
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot Cloud: 9.7.0.cl
     */
    ShowSageQuery = 'showSageQuery',
    /**
     *
     * Action ID to hide or disable the edit option for the
     * results generated from the
     * Natural Language Search query.
     *
     * @example
     * ```js
     * disabledActions: [Action.EditSageAnswer]
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot Cloud: 9.7.0.cl
     */
    EditSageAnswer = 'editSageAnswer',
    /**
     * The feedback widget for AI-generated Answers.
     * Allows users to send feedback on the Answers generated
     * from a Natural Language Search query.
     *
     * @example
     * ```js
     * disabledActions: [Action.SageAnswerFeedback]
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     */
    SageAnswerFeedback = 'sageAnswerFeedback',
    /**
     *
     * @example
     * ```js
     * disabledActions: [Action.ModifySageAnswer]
     * ```
     * @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl
     */
    ModifySageAnswer = 'modifySageAnswer',
    /**
     * The **Move to Tab** menu action on visualizations in Liveboard edit mode.
     * Allows moving a visualization to a different tab.
     * @example
     * ```js
     * disabledActions: [Action.MoveToTab]
     * ```
     */
    MoveToTab = 'onContainerMove',
    /**
     * The **Manage Alerts** menu action on KPI visualizations.
     * Allows creating, viewing, and editing monitor
     * alerts for a KPI chart.
     *
     * @example
     * ```js
     * disabledActions: [Action.ManageMonitor]
     * ```
     */
    ManageMonitor = 'manageMonitor',
    /**
     * The Liveboard Personalised Views dropdown.
     * Allows navigating to a personalized Liveboard View.
     * This action is deprecated. Use {@link Action.PersonalizedViewsDropdown} instead.
     *  @example
     * ```js
     * disabledActions: [Action.PersonalisedViewsDropdown]
     * ```
     *  @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 10.1.0.sw
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    PersonalisedViewsDropdown = 'personalisedViewsDropdown',
    /**
     * The Liveboard Personalized Views dropdown.
     * Allows navigating to a personalized Liveboard View.
     *  @example
     * ```js
     * disabledActions: [Action.PersonalizedViewsDropdown]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    PersonalizedViewsDropdown = PersonalisedViewsDropdown,
    /**
     * Action ID for show or hide the user details on a
     * Liveboard (Recently visited / social proof)
     *  @example
     * ```js
     * disabledActions: [Action.LiveboardUsers]
     * ```
     *  @version SDK: 1.26.0 | ThoughtSpot: 9.7.0.cl, 10.1.0.sw
     */
    LiveboardUsers = 'liveboardUsers',

    /**
     * Action ID for the Parent TML action
     * The parent action **TML** must be included to access TML-related options
     * within the cascading menu (specific to the Answer page)
     * @example
     * ```js
     * // to include specific TML actions
     * visibleActions: [Action.TML, Action.ExportTML, Action.EditTML]
     *
     * ```
     * @example
     * ```js
     * hiddenAction: [Action.TML] // hide all TML actions
     * disabledActions: [Action.TML] // to disable all TML actions
     * ```
     * @version SDK: 1.28.3 | ThoughtSpot: 9.12.0.cl, 10.1.0.sw
     */
    TML = 'tml',
    /**
     * The **Create Liveboard* action on
     * the Liveboards page and the Pin modal.
     * Allows users to create a Liveboard.
     *
     * @example
     * ```js
     * hiddenAction: [Action.CreateLiveboard]
     * disabledActions: [Action.CreateLiveboard]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot: 10.1.0.cl, 10.1.0.sw
     */
    CreateLiveboard = 'createLiveboard',

    /**
     * Action ID for to hide or disable the
     * Verified Liveboard banner.
     *  @example
     * ```js
     * hiddenAction: [Action.VerifiedLiveboard]
     * ```
     *  @version SDK: 1.29.0 | ThoughtSpot: 9.10.0.cl, 10.1.0.sw
     */
    VerifiedLiveboard = 'verifiedLiveboard',

    /**
     * Action ID for the *Ask Sage* In Natural Language Search embed,
     * *Spotter* in Liveboard, full app, and Spotter embed.
     *
     * Allows initiating a conversation with ThoughtSpot AI analyst.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.AskAi]
     * ```
     *  @version SDK: 1.29.0 | ThoughtSpot Cloud: 9.12.0.cl
     */
    AskAi = 'AskAi',

    /**
     * The **Add KPI to Watchlist** action on Home page watchlist.
     * Adds a KPI chart to the watchlist on the Home page.
     * @example
     * ```js
     * disabledActions: [Action.AddToWatchlist]
     * ```
     * @version SDK: 1.27.9 | ThoughtSpot Cloud: 9.12.5.cl
     */
    AddToWatchlist = 'addToWatchlist',

    /**
     * The **Remove from watchlist** menu action on KPI watchlist.
     * Removes a KPI chart from the watchlist on the Home page.
     * @example
     * ```js
     * disabledActions: [Action.RemoveFromWatchlist]
     * ```
     * @version SDK: 1.27.9 | ThoughtSpot: 9.12.5.cl
     */
    RemoveFromWatchlist = 'removeFromWatchlist',
    /**
     * The **Organize Favourites** action on Homepage
     * *Favorites* module.
     * This action is deprecated. Use {@link Action.OrganizeFavorites} instead.
     *
     * @example
     * ```js
     * disabledActions: [Action.OrganiseFavourites]
     * ```
     * @version SDK: 1.32.0 | ThoughtSpot: 10.0.0.cl
     * @deprecated SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    OrganiseFavourites = 'organiseFavourites',

    /**
     * The **Organize Favorites** action on Homepage
     * *Favorites* module.
     *
     * @example
     * ```js
     * disabledActions: [Action.OrganizeFavorites]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot: 26.5.0.cl
     */
    OrganizeFavorites = OrganiseFavourites,

    /**
     * The **AI Highlights** action on a Liveboard.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.AIHighlights]
     * ```
     *  @version SDK: 1.27.10 | ThoughtSpot Cloud: 9.12.5.cl
     */
    AIHighlights = 'AIHighlights',

    /**
     * The *Edit* action on the *Liveboard Schedules* page
     * (new Homepage experience).
     * Allows editing Liveboard schedules.
     *
     * @example
     * ```js
     * disabledActions: [Action.EditScheduleHomepage]
     * ```
     *  @version SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
     */
    EditScheduleHomepage = 'editScheduleHomepage',

    /**
     * The *Pause* action on the *Liveboard Schedules* page
     * Pauses a scheduled Liveboard job.
     * @example
     * ```js
     * disabledActions: [Action.PauseScheduleHomepage]
     * ```
     *  @version SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
     */
    PauseScheduleHomepage = 'pauseScheduleHomepage',

    /**
     * The **View run history** action **Liveboard Schedules** page.
     * Allows viewing schedule run history.
     * @example
     * ```js
     * disabledActions: [Action.ViewScheduleRunHomepage]
     * ```
     *  @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
     */
    ViewScheduleRunHomepage = 'viewScheduleRunHomepage',

    /**
     * Action ID to hide or disable the
     * unsubscribe option for Liveboard schedules.
     * @example
     * ```js
     * disabledActions: [Action.UnsubscribeScheduleHomepage]
     * ```
     *  @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
     */
    UnsubscribeScheduleHomepage = 'unsubscribeScheduleHomepage',

    /**
     * The **Manage Tags** action on Homepage Favourite Module.
     * @example
     * ```js
     * disabledActions: [Action.ManageTags]
     * ```
     * @version SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
     */
    ManageTags = 'manageTags',

    /**
     * The **Delete** action on the **Liveboard Schedules* page.
     * Deletes a Liveboard schedule.
     * @example
     * ```js
     * disabledActions: [Action.DeleteScheduleHomepage]
     * ```
     *  @version SDK: 1.34.0 | ThoughtSpot: 10.3.0.cl
     */
    DeleteScheduleHomepage = 'deleteScheduleHomepage',

    /**
     * The **Analyze CTA** action on KPI chart.
     * @example
     * ```js
     * disabledActions: [Action.KPIAnalysisCTA]
     * ```
     *  @version SDK: 1.34.0 | ThoughtSpot Cloud: 10.3.0.cl
     */
    KPIAnalysisCTA = 'kpiAnalysisCTA',
    /**
     * Action ID for disabling chip reorder in Answer and Liveboard
     * @example
     * ```js
     * const disabledActions = [Action.DisableChipReorder]
     * ```
     * @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    DisableChipReorder = 'disableChipReorder',

    /**
     * Action ID to show, hide, or disable filters
     * in a Liveboard tab.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.ChangeFilterVisibilityInTab]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    ChangeFilterVisibilityInTab = 'changeFilterVisibilityInTab',

    /**
     * Action ID to show, hide, or disable all filter surfaces on a Liveboard,
     * including filter, parameter, and cross-filter chips at the liveboard,
     * tab, and group levels. Parameter and cross-filter chips are hide-only.
     *
     *  @example
     * ```js
     * hiddenActions: [Action.AllLiveboardFilters]
     * disabledActions: [Action.AllLiveboardFilters]
     * ```
     *  @version SDK: 1.53.0 | ThoughtSpot: 26.10.0.cl
     */
    AllLiveboardFilters = 'allLiveboardFilters',

    /**
     * The **Data model instructions** button on the Spotter interface.
     * Allows opening the data model instructions modal.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.DataModelInstructions]
     * ```
     *  @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    DataModelInstructions = 'DataModelInstructions',

    /**
     * The **Preview data** button on the Spotter interface.
     * Allows previewing the data used for Spotter queries.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.PreviewDataSpotter]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    PreviewDataSpotter = 'previewDataSpotter',

    /**
     * The **Reset** link on the Spotter interface.
     * Resets the conversation with Spotter.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.ResetSpotterChat]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    ResetSpotterChat = 'resetSpotterChat',
    /**
     * Action ID for hide or disable the
     * Spotter feedback widget.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.SpotterFeedback]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    SpotterFeedback = 'spotterFeedback',
    /**
     * Action ID for hide or disable
     * the previous prompt edit option in Spotter.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.EditPreviousPrompt]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    EditPreviousPrompt = 'editPreviousPrompt',
    /**
     * Action ID for hide or disable
     * the previous prompt deletion option in Spotter.
     *
     *  @example
     * ```js
     * hiddenAction: [Action.DeletePreviousPrompt]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    DeletePreviousPrompt = 'deletePreviousPrompt',
    /**
     * Action ID for hide or disable editing tokens generated from
     * Spotter results.
     *  @example
     * ```js
     * hiddenAction: [Action.EditTokens]
     * ```
     *  @version SDK: 1.36.0 | ThoughtSpot Cloud: 10.6.0.cl
     */
    EditTokens = 'editTokens',
    /**
     * Action ID for hiding rename option for Column rename
     *  @example
     * ```js
     * hiddenAction: [Action.ColumnRename]
     * ```
     *  @version SDK: 1.37.0 | ThoughtSpot Cloud: 10.8.0.cl
     */
    ColumnRename = 'columnRename',
    /**
     * Action ID for hide checkboxes for include or exclude
     * cover and filter pages in the Liveboard PDF
     *  @example
     * ```js
     * hiddenAction: [Action.CoverAndFilterOptionInPDF]
     * ```
     *  @version SDK: 1.37.0 | ThoughtSpot Cloud: 10.8.0.cl
     */
    CoverAndFilterOptionInPDF = 'coverAndFilterOptionInPDF',
    /**
     * Action ID to hide or disable the Coaching workflow in Spotter conversations.
     * When disabled, users cannot access **Add to Coaching** workflow in conversation.
     * The **Add to Coaching** feature allows adding reference questions and
     * business terms to improve Spotter’s responses. This feature is generally available
     * (GA) from version 26.2.0.cl and enabled by default on embed deployments.
     *
     * This action governs both the answer-card **Add to memory** CTA and its
     * Spotter 3 successor, the response-footer **Remember this** CTA
     * (they are mutually exclusive).
     *  @example
     * ```js
     * hiddenAction: [Action.InConversationTraining]
     * disabledActions: [Action.InConversationTraining]
     *
     * ```
     *  @version SDK: 1.39.0 | ThoughtSpot Cloud: 10.10.0.cl
     */
    InConversationTraining = 'InConversationTraining',
    /**
     * Action ID to hide the warnings banner in
     * Spotter results. It's an EA feature and
     * handled by LD.
     *  @example
     * ```js
     * hiddenAction: [Action.SpotterWarningsBanner]
     * ```
     *  @version SDK: 1.41.0 | ThoughtSpot Cloud: 10.13.0.cl
     */
    SpotterWarningsBanner = 'SpotterWarningsBanner',
    /**
     * Action ID to hide the warnings border on the knowledge
     * card in Spotter results. It's an EA feature and
     * handled by LD.
     *  @example
     * ```js
     * hiddenAction: [Action.SpotterWarningsOnTokens]
     * ```
     *  @version SDK: 1.41.0 | ThoughtSpot Cloud: 10.13.0.cl
     */
    SpotterWarningsOnTokens = 'SpotterWarningsOnTokens',
    /**
     * Action ID to disable the click event handler on knowledge
     * card in Spotter results. It's an EA feature and
     * handled by LD.
     *  @example
     * ```js
     * hiddenAction: [Action.SpotterTokenQuickEdit]
     * ```
     *  @version SDK: 1.41.0 | ThoughtSpot Cloud: 10.13.0.cl
     */
    SpotterTokenQuickEdit = 'SpotterTokenQuickEdit',
    /**
     * The **PNG screenshot in email** option in the schedule email dialog.
     * Includes a PNG screenshot in the notification email body.
     * @example
     * ```js
     * disabledActions: [Action.PngScreenshotInEmail]
     * ```
     * ```
     *  @version SDK: 1.42.0 | ThoughtSpot Cloud: 10.14.0.cl
     */
    PngScreenshotInEmail = 'pngScreenshotInEmail',
    /**
     * The **Remove attachment** action in the schedule email dialog.
     * Removes an attachment from the email configuration.
     * @example
     * ```js
     * disabledActions: [Action.RemoveAttachment]
     * ```
     * ```
     * ```
     *  @version SDK: 1.42.0 | ThoughtSpot Cloud: 10.14.0.cl
     */
    RemoveAttachment = 'removeAttachment',
    /**
     * The **Style panel** on a Liveboard.
     * Controls the visibility of the Liveboard style panel.
     * @example
     * ```js
     * hiddenActions: [Action.LiveboardStylePanel]
     * ```
     * @version SDK: 1.43.0 | ThoughtSpot Cloud: 10.15.0.cl
     */
    LiveboardStylePanel = 'liveboardStylePanel',
    /**
     * The **Publish** action for Liveboards, Answers and Models.
     * Opens the publishing modal. It's a parent action for the
     * **Manage Publishing** and **Unpublish** actions if the object
     * is already published, otherwise appears standalone.
     * @example
     * ```js
     * hiddenActions: [Action.Publish]
     * disabledActions: [Action.Publish]
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    Publish = 'publish',
    /**
     * The **Manage Publishing** action for Liveboards, Answers and Models.
     * Opens the same publishing modal as the **Publish** action.
     * Appears as a child action to the **Publish** action if the
     * object is already published.
     * @example
     * ```js
     * hiddenActions: [Action.ManagePublishing]
     * disabledActions: [Action.ManagePublishing]
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    ManagePublishing = 'managePublishing',
    /**
     * The **Unpublish** action for Liveboards, Answers and Models.
     * Opens the unpublishing modal. Appears as a child action to
     * the **Publish** action if the object is already published.
     * @example
     * ```js
     * hiddenActions: [Action.Unpublish]
     * disabledActions: [Action.Unpublish]
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    Unpublish = 'unpublish',
    /**
     * The **Parameterize** action for Tables and Connections.
     * Opens the parameterization modal.
     * @example
     * ```js
     * hiddenActions: [Action.Parameterize]
     * disabledActions: [Action.Parameterize]
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    Parameterize = 'parameterise',
    /**
     * The **Move to Group** menu action on a Liveboard.
     * Allows moving a visualization to a different group.
     * @example
     * ```js
     * disabledActions: [Action.MoveToGroup]
     * ```
     * @version SDK: 1.44.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    MoveToGroup = 'moveToGroup',
    /**
     * The **Move out of Group** menu action on a Liveboard.
     * Allows moving a visualization out of a group.
     * @example
     * ```js
     * disabledActions: [Action.MoveOutOfGroup]
     * ```
     * @version SDK: 1.44.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    MoveOutOfGroup = 'moveOutOfGroup',
    /**
     * The **Create Group** menu action on a Liveboard.
     * Allows creating a new group.
     * @example
     * ```js
     * disabledActions: [Action.CreateGroup]
     * ```
     * @version SDK: 1.44.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    CreateGroup = 'createGroup',
    /**
     * The **Ungroup Liveboard Group** menu action on a Liveboard.
     * Allows ungrouping a liveboard group.
     * @example
     * ```js
     * disabledActions: [Action.UngroupLiveboardGroup]
     * ```
     * @version SDK: 1.44.0 | ThoughtSpot Cloud: 26.2.0.cl
     */
    UngroupLiveboardGroup = 'ungroupLiveboardGroup',
    /**
     * Controls visibility of the sidebar header (title and toggle button)
     * in the Spotter past conversations sidebar.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterSidebarHeader]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterSidebarHeader = 'spotterSidebarHeader',
    /**
     * Controls visibility of the sidebar footer (documentation link)
     * in the Spotter past conversations sidebar.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterSidebarFooter]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterSidebarFooter = 'spotterSidebarFooter',
    /**
     * Controls visibility and disable state of the sidebar toggle/expand button
     * in the Spotter past conversations sidebar.
     * @example
     * ```js
     * disabledActions: [Action.SpotterSidebarToggle]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterSidebarToggle = 'spotterSidebarToggle',
    /**
     * Controls visibility and disable state of the "New Chat" button
     * in the Spotter past conversations sidebar.
     * @example
     * ```js
     * disabledActions: [Action.SpotterNewChat]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterNewChat = 'spotterNewChat',
    /**
     * Controls visibility of the past conversation banner alert
     * in the Spotter interface.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterPastChatBanner]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterPastChatBanner = 'spotterPastChatBanner',
    /**
     * Controls visibility and disable state of the conversation edit menu
     * (three-dot menu) in the Spotter past conversations sidebar.
     * @example
     * ```js
     * disabledActions: [Action.SpotterChatMenu]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterChatMenu = 'spotterChatMenu',
    /**
     * Controls visibility and disable state of the rename action
     * in the Spotter conversation edit menu.
     * @example
     * ```js
     * disabledActions: [Action.SpotterChatRename]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterChatRename = 'spotterChatRename',
    /**
     * Controls visibility and disable state of the Spotter conversation Share
     * button in the chat header. Only takes effect once sharing is enabled
     * (enableShareConversation on).
     * @example
     * ```js
     * disabledActions: [Action.SpotterShareConversationButtonHeader]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareConversationButtonHeader = 'spotterShareConversationButtonHeader',
    /**
     * Controls visibility and disable state of the Share item in the Spotter
     * conversation history (sidebar) edit menu. Independent of the header button
     * above, so a host can show Share in one entry point and hide it in the other.
     * @example
     * ```js
     * disabledActions: [Action.SpotterShareConversationMenuItemSidebar]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareConversationMenuItemSidebar = 'spotterShareConversationMenuItemSidebar',
    /**
     * Controls visibility of the entire read-only shared-conversation data-access
     * banner shown when a recipient opens a shared view. Hide-only.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterSharedConversationBanner]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterSharedConversationBanner = 'spotterSharedConversationBanner',
    /**
     * Controls visibility and disable state of the cross/close button on the
     * read-only shared-conversation data-access banner (keeps the banner itself).
     * @example
     * ```js
     * hiddenActions: [Action.SpotterSharedConversationBannerDismissButton]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterSharedConversationBannerDismissButton = 'spotterSharedConversationBannerDismissButton',
    /**
     * Controls visibility and disable state of the Exit button in the read-only
     * shared-view header. Hiding it does not disable the ExitSpotterSharedConversation
     * host event.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterSharedConversationExitButton]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterSharedConversationExitButton = 'spotterSharedConversationExitButton',
    /**
     * Controls visibility of the share-modal footer note ("Chat will be shared up
     * to the current moment…"). Hide-only.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterShareUpToCurrentInfo]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareUpToCurrentInfo = 'spotterShareUpToCurrentInfo',
    /**
     * Controls visibility and disable state of the share-modal "include new
     * messages since last shared version" checkbox.
     * @example
     * ```js
     * disabledActions: [Action.SpotterShareIncludeNewMessagesCheckbox]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareIncludeNewMessagesCheckbox = 'spotterShareIncludeNewMessagesCheckbox',
    /**
     * Controls visibility and disable state of the cross on the share-modal
     * stale-snapshot info banner.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterShareStaleInfoBannerDismissButton]
     * ```
     * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
     */
    SpotterShareStaleInfoBannerDismissButton = 'spotterShareStaleInfoBannerDismissButton',
    /**
     * Controls visibility and disable state of the delete action
     * in the Spotter conversation edit menu.
     * @example
     * ```js
     * disabledActions: [Action.SpotterChatDelete]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterChatDelete = 'spotterChatDelete',
    /**
     * Controls visibility and disable state of the pin/unpin action
     * in the Spotter conversation edit menu.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * disabledActions: [Action.SpotterChatPin]
     * ```
     */
    SpotterChatPin = 'spotterChatPin',
    /**
     * Controls visibility and disable state of the documentation/best practices
     * link in the Spotter sidebar footer.
     * @example
     * ```js
     * disabledActions: [Action.SpotterDocs]
     * ```
     * @version SDK: 1.46.0 | ThoughtSpot Cloud: 26.3.0.cl
     */
    SpotterDocs = 'spotterDocs',
    /**
     * Controls visibility and disable state of the connector resources
     * section in the Spotter chat interface.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterChatConnectorResources]
     * disabledActions: [Action.SpotterChatConnectorResources]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
     */
    SpotterChatConnectorResources = 'spotterChatConnectorResources',
    /**
     * Controls visibility and disable state of the connectors
     * in the Spotter chat interface.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterChatConnectors]
     * disabledActions: [Action.SpotterChatConnectors]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
     */
    SpotterChatConnectors = 'spotterChatConnectors',
    /**
     * Controls visibility and disable state of the mode switcher
     * in the Spotter chat interface.
     * @example
     * ```js
     * hiddenActions: [Action.SpotterChatModeSwitcher]
     * disabledActions: [Action.SpotterChatModeSwitcher]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
     */
    SpotterChatModeSwitcher = 'spotterChatModeSwitcher',
    /**
     * The **Basic Search** starter prompt pill.
     *
     * Starter prompt pills are the row of category buttons shown above the
     * Spotter chat input before a conversation starts. They give a new user
     * ready-made questions to click instead of typing one from scratch, and
     * disappear once the conversation begins. There are three, one per action
     * below.
     *
     * Clicking this pill opens a card of suggested simple questions; picking one
     * submits it to Spotter right away. Visible by default, and hidden along
     * with the other pills when the surface itself is off (see
     * {@link SpotterChatViewConfig.starterPrompts}).
     * @example
     * ```js
     * hiddenActions: [Action.QuickSearchPill]
     * ```
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    QuickSearchPill = 'quickSearchPill',
    /**
     * The **Deep Analysis** starter prompt pill, next to
     * {@link Action.QuickSearchPill} above the Spotter chat input.
     *
     * Clicking it opens a card of suggested investigative questions ("why did
     * revenue drop?"). Picking one fills the chat input in Deep Analysis mode
     * rather than submitting immediately, so the user can edit it first.
     * Visible by default.
     * @example
     * ```js
     * hiddenActions: [Action.DeepAnalysisPill]
     * ```
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    DeepAnalysisPill = 'deepAnalysisPill',
    /**
     * The **Data Literacy** starter prompt pill, next to
     * {@link Action.QuickSearchPill} above the Spotter chat input.
     *
     * Unlike the other two pills it opens no card: clicking it submits a prompt
     * that describes the data the model can answer over, helping a user who does
     * not yet know what is in the data source. The prompt text always comes from
     * ThoughtSpot, so only its label is customizable. Visible by default.
     * @example
     * ```js
     * hiddenActions: [Action.DataLiteracyPill]
     * ```
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     */
    DataLiteracyPill = 'dataLiteracyPill',
    /**
     * The **Include current period** checkbox for date filters.
     * Controls the visibility and availability of the option to include
     * the current time period in filter results.
     * @example
     * ```js
     * hiddenActions: [Action.IncludeCurrentPeriod]
     * disabledActions: [Action.IncludeCurrentPeriod]
     * ```
     * @version SDK: 1.45.0 | ThoughtSpot: 26.4.0.cl
     */
    IncludeCurrentPeriod = 'includeCurrentPeriod',
    /**
     * The **Send Test Email** button in the Liveboard schedule modal.
     * Allows sending a test schedule email to self or all recipients.
     * Requires `isSendNowLiveboardSchedulingEnabled` to be enabled.
     * @example
     * ```js
     * disabledActions: [Action.SendTestScheduleEmail]
     * hiddenActions: [Action.SendTestScheduleEmail]
     * ```
     * @version SDK: 1.48.0 | ThoughtSpot Cloud: 26.5.0.cl
     */
    SendTestScheduleEmail = 'sendTestScheduleEmail',

    /**
     * The thumbs up/down feedback buttons in the SpotterViz panel.
     * Visible by default.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterVizFeedback]
     * disabledActions: [Action.SpotterVizFeedback]
     * ```
     */
    SpotterVizFeedback = 'spotterVizFeedback',

    /**
     * The version restore button on checkpoint cards in the SpotterViz panel.
     * Visible by default.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterVizCheckpointRestore]
     * disabledActions: [Action.SpotterVizCheckpointRestore]
     * ```
     */
    SpotterVizCheckpointRestore = 'spotterVizCheckpointRestore',

    /**
     * The **SpotterViz** button in the top edit header.
     * Visible by default.
     * @version SDK: 1.50.0 | ThoughtSpot Cloud: 26.7.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterViz]
     * disabledActions: [Action.SpotterViz]
     * ```
     */
    SpotterViz = 'spotterViz',
    /**
     * The reference-mode toggle button inside the SpotterViz chat input.
     * When users enable reference mode, clicking tiles, filters, or
     * parameters adds them as chat context. Hide this action to remove
     * the reference-mode capability entirely.
     * Visible by default.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterVizReferenceMode]
     * disabledActions: [Action.SpotterVizReferenceMode]
     * ```
     */
    SpotterVizReferenceMode = 'spotterVizReferenceMode',
    /**
     * Clears browser cache and fetches new data for liveboard ChartViz Containers.
     * Requires `enableLiveboardDataCache` to be enabled.
     * @example
     * ```js
     * disabledActions: [Action.RefreshLiveboardBrowserCache]
     * hiddenActions: [Action.RefreshLiveboardBrowserCache]
     * ```
     * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
     */
    RefreshLiveboardBrowserCache = 'refreshLiveboardBrowserCache',
    /**
     * Controls visibility and disable state of the share action
     * in the Spotter Analyst interface.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystShare]
     * disabledActions: [Action.SpotterAnalystShare]
     * ```
     */
    SpotterAnalystShare = 'spotterAnalystShare',
    /**
     * Controls visibility and disable state of the edit action
     * in the Spotter Analyst interface.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystEdit]
     * disabledActions: [Action.SpotterAnalystEdit]
     * ```
     */
    SpotterAnalystEdit = 'spotterAnalystEdit',
    /**
     * Controls visibility and disable state of the create action
     * in the Spotter Analyst interface.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystCreate]
     * disabledActions: [Action.SpotterAnalystCreate]
     * ```
     */
    SpotterAnalystCreate = 'spotterAnalystCreate',
    /**
     * Controls visibility and disable state of the delete action
     * in the Spotter Analyst interface.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystDelete]
     * disabledActions: [Action.SpotterAnalystDelete]
     * ```
     */
    SpotterAnalystDelete = 'spotterAnalystDelete',
    /**
     * Controls visibility and disable state of the make a copy action
     * in the Spotter Analyst interface.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystMakeACopy]
     * disabledActions: [Action.SpotterAnalystMakeACopy]
     * ```
     */
    SpotterAnalystMakeACopy = 'spotterAnalystMakeACopy',
    /**
     * Controls visibility and disable state of the sidebar
     * in the Spotter Analyst interface.
     * @version SDK: 1.51.0 | ThoughtSpot Cloud: 26.8.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystSidebar]
     * disabledActions: [Action.SpotterAnalystSidebar]
     * ```
     */
    SpotterAnalystSidebar = 'spotterAnalystSidebar',
    /**
     * Controls visibility and disable state of the analyst list
     * ("Show all") in the Spotter Analyst interface.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterAnalystList]
     * disabledActions: [Action.SpotterAnalystList]
     * ```
     */
    SpotterAnalystList = 'spotterAnalystList',
    /**
     * Controls visibility and disable state of the default Spotter analyst
     * entry in the Spotter Analyst interface.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterDefaultAnalyst]
     * disabledActions: [Action.SpotterDefaultAnalyst]
     * ```
     */
    SpotterDefaultAnalyst = 'spotterDefaultAnalyst',
    /**
     * The **Spotter** button in the Liveboard header.
     * @version SDK: 1.53.0 | ThoughtSpot Cloud: 26.10.0.cl
     * @example
     * ```js
     * hiddenActions: [Action.SpotterOnLiveboard]
     * disabledActions: [Action.SpotterOnLiveboard]
     * ```
     */
    SpotterOnLiveboard = 'spotterOnLiveboard',
    /**
     * Controls the visibility and disabled state of the "Chart Type" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.ChartTypeSettings],
     *     disabledActions: [Action.ChartTypeSettings],
     * }
     * ```
     */
    ChartTypeSettings = 'CHART_TYPE',
    /**
     * Controls the visibility and disabled state of the "Layout" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.LayoutSettings],
     *     disabledActions: [Action.LayoutSettings],
     * }
     * ```
     */
    LayoutSettings = 'LAYOUT',
    /**
     * Controls the visibility and disabled state of the "Column" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.ColumnSettings],
     *     disabledActions: [Action.ColumnSettings],
     * }
     * ```
     */
    ColumnSettings = 'COLUMN',
    /**
     * Controls the visibility and disabled state of the "Axis" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.AxisSettings],
     *     disabledActions: [Action.AxisSettings],
     * }
     * ```
     */
    AxisSettings = 'AXIS',
    /**
     * Controls the visibility and disabled state of the "Data Label" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.DataLabelSettings],
     *     disabledActions: [Action.DataLabelSettings],
     * }
     * ```
     */
    DataLabelSettings = 'DATA_LABEL',
    /**
     * Controls the visibility and disabled state of the "Tooltip" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.TooltipSettings],
     *     disabledActions: [Action.TooltipSettings],
     * }
     * ```
     */
    TooltipSettings = 'TOOLTIP',
    /**
     * Controls the visibility and disabled state of the "Legend" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.LegendSettings],
     *     disabledActions: [Action.LegendSettings],
     * }
     * ```
     */
    LegendSettings = 'LEGEND',
    /**
     * Controls the visibility and disabled state of the "Display" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.DisplaySettings],
     *     disabledActions: [Action.DisplaySettings],
     * }
     * ```
     */
    DisplaySettings = 'DISPLAY',
    /**
     * Controls the visibility and disabled state of the "Query Details" menu
     * item in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.QuerySettings],
     *     disabledActions: [Action.QuerySettings],
     * }
     * ```
     */
    QuerySettings = 'QUERY_DETAILS',
    /**
     * Controls the visibility and disabled state of the "Custom Action" menu
     * item in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.CustomSettings],
     *     disabledActions: [Action.CustomSettings],
     * }
     * ```
     */
    CustomSettings = 'CUSTOM_ACTION',
    /**
     * Controls the visibility and disabled state of the "Muze AI" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.MuzeAiSettings],
     *     disabledActions: [Action.MuzeAiSettings],
     * }
     * ```
     */
    MuzeAiSettings = 'MUZE_AI',
    /**
     * Controls the visibility and disabled state of the "R Analysis" menu item
     * in Chart Settings V2.
     * @version SDK: 1.54.0 | ThoughtSpot Cloud: 26.11.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.RAnalysisSettings],
     *     disabledActions: [Action.RAnalysisSettings],
     * }
     * ```
     */
    RAnalysisSettings = 'R_ANALYSIS',
    /**
     * Controls the visibility and disabled state of the "Add to Collection" menu item.
     * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.AddToCollection],
     *     disabledActions: [Action.AddToCollection],
     * }
     * ```
     */
    AddToCollection = 'addToCollection',
    /**
     * Controls the visibility and disabled state of the "Create Collection" button.
     * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.CreateCollection],
     *     disabledActions: [Action.CreateCollection],
     * }
     * ```
     */
    CreateCollection = 'createCollection',
    /**
     * Controls the visibility and disabled state of the "Move" menu item in a
     * Collection.
     * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.MoveToCollection],
     *     disabledActions: [Action.MoveToCollection],
     * }
     * ```
     */
    MoveToCollection = 'moveToCollection',
    /**
     * Controls the visibility and disabled state of the "Remove" menu item in a
     * Collection.
     * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.RemoveFromCollection],
     *     disabledActions: [Action.RemoveFromCollection],
     * }
     * ```
     */
    RemoveFromCollection = 'removeFromCollection',
    /**
     * Controls the visibility and disabled state of the "Delete" menu item for a
     * Collection.
     * @version SDK: 1.52.1 | ThoughtSpot Cloud: 26.5.0.cl
     * @example
     * ```js
     * {
     *     hiddenActions: [Action.DeleteCollection],
     *     disabledActions: [Action.DeleteCollection],
     * }
     * ```
     */
    DeleteCollection = 'deleteCollection',
}
export interface AnswerServiceType {
    getAnswer?: (offset: number, batchSize: number) => any;
}

export enum PrefetchFeatures {
    FullApp = 'FullApp',
    SearchEmbed = 'SearchEmbed',
    LiveboardEmbed = 'LiveboardEmbed',
    VizEmbed = 'VizEmbed',
}

/**
 * Enum for options to change context trigger.
 * The `BOTH_CLICKS` option is available from 10.8.0.cl.
 */
export enum ContextMenuTriggerOptions {
    LEFT_CLICK = 'left-click',
    RIGHT_CLICK = 'right-click',
    BOTH_CLICKS = 'both-clicks',
}

export interface ColumnValue {
    column: {
        id: string;
        name: string;
        dataType: string;
        [key: string]: any;
    };
    value:
        | string
        | number
        | boolean
        | {
              v: {
                  s: number;
                  e: number;
              };
          };
}

export interface VizPoint {
    selectedAttributes: ColumnValue[];
    selectedMeasures: ColumnValue[];
}

/**
 * @group Events
 */
export interface CustomActionPayload {
    /**
     * Id of the custom action that was triggered. Matches the `id` you set on
     * the {@link CustomAction}. Omitted on Liveboard-level code-based actions.
     */
    id?: string;
    contextMenuPoints?: {
        clickedPoint: VizPoint;
        selectedPoints: VizPoint[];
    };
    embedAnswerData: {
        name: string;
        id: string;
        sources: {
            header: {
                guid: string;
            };
        };
        columns: any[];
        data: any[];
        [key: string]: any;
    };
    session: SessionInterface;
    vizId?: string;
}

/**
 * A code-based custom action to inject into the embedded ThoughtSpot UI.
 * Pass an array of these as `customActions` in the embed view config. When a
 * user invokes the action, the host emits {@link EmbedEvent.CustomAction} with
 * a {@link CustomActionPayload} carrying the same `id`.
 */
export interface CustomAction {
    /**
     * Display label shown on the action's button or menu item.
     */
    name: string;
    /**
     * Unique identifier for the action. Echoed back as `id` on the
     * {@link CustomActionPayload} when the action is invoked.
     */
    id: string;
    /**
     * Where the action appears: a primary button, the "More" menu, or the
     * right-click context menu. See {@link CustomActionsPosition}.
     */
    position: CustomActionsPosition;
    /**
     * The surface the action applies to (Liveboard, visualization, Answer, or
     * Spotter). See {@link CustomActionTarget}. The allowed `position` values
     * and scoping keys depend on the target.
     */
    target: CustomActionTarget;
    /**
     * Scope the action to specific objects by GUID. Which keys are allowed
     * depends on `target` (for example, a `VIZ` action may use `answerIds`,
     * `liveboardIds`, and `vizIds`).
     */
    metadataIds?: {
        answerIds?: string[];
        liveboardIds?: string[];
        vizIds?: string[];
    };
    /**
     * Scope the action by data model, using model GUIDs or column names.
     * Allowed for `VIZ`, `ANSWER`, and `SPOTTER` targets.
     */
    dataModelIds?: {
        modelIds?: string[];
        modelColumnNames?: string[];
    };
    /**
     * Restrict the action to specific organizations by ID.
     */
    orgIds?: string[];
    /**
     * Restrict the action to specific user groups by ID.
     */
    groupIds?: string[];
}

/**
 * Enum options to show custom actions at different
 * positions in the application.
 */
export enum CustomActionsPosition {
    /**
     * Shows the action as a primary button
     * in the toolbar area of the embed.
     */
    PRIMARY = 'PRIMARY',
    /**
     * Shows the action inside the "More" menu
     * (three-dot overflow menu).
     */
    MENU = 'MENU',
    /**
     * Shows the action in the right-click
     * context menu. Only supported for
     * {@link CustomActionTarget.VIZ},
     * {@link CustomActionTarget.ANSWER}, and
     * {@link CustomActionTarget.SPOTTER} targets.
     */
    CONTEXTMENU = 'CONTEXTMENU',
}

/**
 * Enum options to mention the target of the code-based custom action.
 * The target determines which type of ThoughtSpot object the action is
 * associated with, and also controls which positions and scoping options
 * are available.
 */
export enum CustomActionTarget {
    /**
     * Action applies at the Liveboard level.
     * Supported positions:
     * {@link CustomActionsPosition.PRIMARY},
     * {@link CustomActionsPosition.MENU}.
     * Can be scoped with
     * `metadataIds.liveboardIds`,
     * `orgIds`, and `groupIds`.
     */
    LIVEBOARD = 'LIVEBOARD',
    /**
     * Action applies to individual
     * visualizations (charts/tables).
     * Supported positions:
     * {@link CustomActionsPosition.PRIMARY},
     * {@link CustomActionsPosition.MENU},
     * {@link CustomActionsPosition.CONTEXTMENU}.
     * Can be scoped with `metadataIds`
     * (answerIds, liveboardIds, vizIds),
     * `dataModelIds` (modelIds,
     * modelColumnNames), `orgIds`,
     * and `groupIds`.
     */
    VIZ = 'VIZ',
    /**
     * Action applies to saved or unsaved
     * Answers. Supported positions:
     * {@link CustomActionsPosition.PRIMARY},
     * {@link CustomActionsPosition.MENU},
     * {@link CustomActionsPosition.CONTEXTMENU}.
     * Can be scoped with
     * `metadataIds.answerIds`,
     * `dataModelIds` (modelIds,
     * modelColumnNames), `orgIds`,
     * and `groupIds`.
     */
    ANSWER = 'ANSWER',
    /**
     * Action applies to Spotter
     * (AI-powered search).
     * Supported positions:
     * {@link CustomActionsPosition.MENU},
     * {@link CustomActionsPosition.CONTEXTMENU}.
     * Can be scoped with
     * `dataModelIds.modelIds`,
     * `orgIds`, and `groupIds`.
     */
    SPOTTER = 'SPOTTER',
}

/**
 * Enum options to show or suppress Visual Embed SDK and
 * ThoughtSpot application logs in the console output.
 * This attribute doesn't support suppressing
 * browser warnings or errors.
 */

export enum LogLevel {
    /**
     * No application or SDK-related logs will be logged
     * in the console output.
     * @example
     * ```js
     * init({
     *   ... //other embed view config,
     *  logLevel: LogLevel.SILENT,
     * })
     * ```
     * @version SDK: 1.26.7 | ThoughtSpot Cloud: 9.10.0.cl
     */
    SILENT = 'SILENT',
    /**
     * Log only errors in the console output.
     * @example
     * ```js
     * init({
     *   ... //other embed view config,
     *  logLevel: LogLevel.ERROR,
     * })
     * ```
     * @version SDK: 1.26.7 | ThoughtSpot Cloud: 9.10.0.cl
     */
    ERROR = 'ERROR',
    /**
     * Log only warnings and errors in the console output.
     * @example
     * ```js
     * init({
     *   ... //other embed view config,
     *  logLevel: LogLevel.WARN,
     * })
     * ```
     * @version SDK: 1.26.7 | ThoughtSpot Cloud: 9.10.0.cl
     */
    WARN = 'WARN',
    /**
     * Log only the information alerts, warnings, and errors
     * in the console output.
     * @example
     * ```js
     * init({
     *   ... //other embed view config,
     *  logLevel: LogLevel.INFO,
     * })
     * ```
     * @version SDK: 1.26.7 | ThoughtSpot Cloud: 9.10.0.cl
     */
    INFO = 'INFO',

    /**
     * Log debug messages, warnings, information alerts,
     * and errors in the console output.
     * @example
     * ```js
     * init({
     *   ... //other embed view config,
     *  logLevel: LogLevel.DEBUG,
     * })
     * ```
     * @version SDK: 1.26.7 | ThoughtSpot Cloud: 9.10.0.cl
     */
    DEBUG = 'DEBUG',
    /**
     * All logs will be logged in the browser console.
     * @example
     * ```js
     * init({
     *   ... //other embed view config,
     *  logLevel: LogLevel.TRACE,
     * })
     * ```
     * @version SDK: 1.26.7 | ThoughtSpot Cloud: 9.10.0.cl
     */
    TRACE = 'TRACE',
}

/**
 * Error types emitted by embedded components.
 *
 * These enum values categorize different types of errors that can occur during
 * the lifecycle of an embedded ThoughtSpot component.
 * Use {@link EmbedErrorDetailsEvent} and {@link EmbedErrorCodes} to handle specific errors.
 * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
 * @group Error Handling
 *
 * @example
 * Handle specific error types
 * ```js
 * embed.on(EmbedEvent.Error, (error) => {
 *   switch (error.errorType) {
 *     case ErrorDetailsTypes.API:
 *       console.error('API error:', error.message);
 *       break;
 *     case ErrorDetailsTypes.VALIDATION_ERROR:
 *       console.error('Validation error:', error.message);
 *       break;
 *     case ErrorDetailsTypes.NETWORK:
 *       console.error('Network error:', error.message);
 *       break;
 *     default:
 *       console.error('Unknown error:', error);
 *   }
 * });
 * ```
 */
export enum ErrorDetailsTypes {
    /** API call failure */
    API = 'API',
    /** General validation error */
    VALIDATION_ERROR = 'VALIDATION_ERROR',
    /** Network connectivity or request error */
    NETWORK = 'NETWORK',
}

/**
 * Error codes for identifying specific issues in embedded ThoughtSpot components. Use
 * {@link EmbedErrorDetailsEvent}  and  {@link ErrorDetailsTypes} codes for precise error
 * handling and debugging.
 *
 * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
 * @group Error Handling

 * @example
 * Handle specific error codes in the error event handler
 * ```js
 * embed.on(EmbedEvent.Error, (error) => {
 *   switch (error.code) {
 *     case EmbedErrorCodes.WORKSHEET_ID_NOT_FOUND:
 *       console.error('Worksheet ID not found:', error.message);
 *       break;
 *     case EmbedErrorCodes.LIVEBOARD_ID_MISSING:
 *       console.error('Liveboard ID is missing:', error.message);
 *       break;
 *     case EmbedErrorCodes.CONFLICTING_ACTIONS_CONFIG:
 *       console.error('Conflicting actions configuration:', error.message);
 *       break;
 *     case EmbedErrorCodes.CONFLICTING_TABS_CONFIG:
 *       console.error('Conflicting tabs configuration:', error.message);
 *       break;
 *     default:
 *       console.error('Unknown error:', error);
 *   }
 * });
 * ```
 * */
export enum EmbedErrorCodes {
    /** Worksheet ID not found or does not exist */
    WORKSHEET_ID_NOT_FOUND = 'WORKSHEET_ID_NOT_FOUND',

    /** Required Liveboard ID is missing from configuration */
    LIVEBOARD_ID_MISSING = 'LIVEBOARD_ID_MISSING',

    /** Conflicting action configuration detected */
    CONFLICTING_ACTIONS_CONFIG = 'CONFLICTING_ACTIONS_CONFIG',

    /** Conflicting tab configuration detected  */
    CONFLICTING_TABS_CONFIG = 'CONFLICTING_TABS_CONFIG',

    /** Error during component initialization */
    INIT_ERROR = 'INIT_ERROR',

    /** Network connectivity or request error */
    NETWORK_ERROR = 'NETWORK_ERROR',

    /** Custom action validation failed */
    CUSTOM_ACTION_VALIDATION = 'CUSTOM_ACTION_VALIDATION',

    /** Authentication/login failed */
    LOGIN_FAILED = 'LOGIN_FAILED',

    /** Render method was not called before attempting to use the component */
    RENDER_NOT_CALLED = 'RENDER_NOT_CALLED',

    /** Host event type is undefined or invalid */
    HOST_EVENT_TYPE_UNDEFINED = 'HOST_EVENT_TYPE_UNDEFINED',

    /** Error parsing api intercept body */
    PARSING_API_INTERCEPT_BODY_ERROR = 'PARSING_API_INTERCEPT_BODY_ERROR',

    /** Failed to update embed parameters during pre-render */
    UPDATE_PARAMS_FAILED = 'UPDATE_PARAMS_FAILED',

    /** Invalid URL provided in configuration */
    INVALID_URL = 'INVALID_URL',

    /** Host event payload validation failed */
    HOST_EVENT_VALIDATION = 'HOST_EVENT_VALIDATION',

    /** UpdateFilters payload is invalid - missing or malformed filter/filters */
    UPDATEFILTERS_INVALID_PAYLOAD = 'UPDATEFILTERS_INVALID_PAYLOAD',

    /** DrillDown payload is invalid - missing or malformed points */
    DRILLDOWN_INVALID_PAYLOAD = 'DRILLDOWN_INVALID_PAYLOAD',

    /** UpdateParameters payload is invalid - malformed applicability */
    UPDATEPARAMETERS_INVALID_PAYLOAD = 'UPDATEPARAMETERS_INVALID_PAYLOAD',
}

/**
 * Error event object emitted when an error occurs in an embedded component.
 *
 * This interface defines the structure of error objects returned by the {@link
 * EmbedEvent.Error} event. It provides detailed information about what went wrong,
 * including the error type, a human-readable message, and a machine-readable error code.
 *
 * ## Properties
 *
 * - **errorType**: One of the predefined {@link ErrorDetailsTypes} values
 * - **message**: Human-readable error description (string or array of strings for
 * multiple errors)
 * - **code**: Machine-readable error identifier {@link EmbedErrorCodes}
 * values
 * - **[key: string]**: Additional context-specific for backward compatibility
 *
 * ## Usage
 *
 * Listen to the {@link EmbedEvent.Error} event to receive instances of this object
 * and implement appropriate error handling logic based on the `errorType`.
 *
 * @version SDK: 1.44.2 | ThoughtSpot: 26.2.0.cl
 * @group Error Handling
 *
 * @example
 * Handle specific error types
 *
 * ```js
 * embed.on(EmbedEvent.Error, (error) => {
 *   switch (error.code) {
 *     case EmbedErrorCodes.WORKSHEET_ID_NOT_FOUND:
 *       console.error('Worksheet ID not found:', error.message, error.code);
 *       break;
 *     default:
 *       console.error('Unknown error:', error);
 *   }
 * });
 * ```
 * @example
 * Handle multiple error messages
 *
 * ```js
 * embed.on(EmbedEvent.Error, (error) => {
 *   const messages = Array.isArray(error.message)
 *     ? error.message
 *     : [error.message];
 *   messages.forEach(msg => console.error(msg));
 * });
 * ```
 *  */
export interface EmbedErrorDetailsEvent {
    /** The type of error that occurred */
    errorType: ErrorDetailsTypes;
    /** Human-readable error message(s) describing what went wrong */
    message: string | string[];
    /** Machine-readable error code for programmatic error handling */
    code: EmbedErrorCodes;
    /** How badly the embed is affected. Defaults to {@link EmbedErrorSeverity.SEV3}. */
    severity?: EmbedErrorSeverity;
    /** Additional context-specific for backward compatibility */
    [key: string]: any;
}

/**
 * How badly an error affects the embed, so the host can decide whether it is
 * worth surfacing to the end user.
 *
 * Mirrors the severity that ThoughtSpot itself stamps on errors raised inside
 * the embedded app, so a host can apply one rule to both sources.
 *
 * @version SDK: 1.52.0 | ThoughtSpot Cloud: 26.9.0.cl
 * @group Error Handling
 *
 * @example
 * Only surface errors that took the embed down
 *
 * ```js
 * embed.on(EmbedEvent.Error, (error) => {
 *   if (error.severity === EmbedErrorSeverity.SEV1) {
 *     showBanner(error.message);
 *   }
 * });
 * ```
 */
export enum EmbedErrorSeverity {
    /** The embed cannot render. Nothing usable is on screen. */
    SEV1 = 1,
    /** Something is degraded but the embed still works. */
    SEV2 = 2,
    /** Everything else, including validation of the embedder's own input. */
    SEV3 = 3,
}

/**
 * Context types for specifying the page context when triggering host events.
 * Used as the third parameter in the `trigger` method to help ThoughtSpot
 * understand the current page context for better event handling.
 *
 * @example
 * ```js
 * import { HostEvent, ContextType } from '@thoughtspot/visual-embed-sdk';
 *
 * // Trigger an event with specific context
 * embed.trigger(HostEvent.Pin, { vizId: "123", liveboardId: "456" }, ContextType.Search);
 * ```
 *
 * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
 * @group Events
 */
export enum ContextType {
    /**
     * Search answer context for search page or edit viz dialog on liveboard page.
     */
    Search = 'search-answer',
    /**
     * Liveboard context for liveboard page.
     */
    Liveboard = 'liveboard',
    /**
     * Answer context for explore modal/page on liveboard page.
     */
    Answer = 'answer',
    /**
     * Spotter context for spotter modal/page.
     */
    Spotter = 'spotter',

    /**
     * Other context for any other generic page.
     */
    Other = 'other',
}

export interface DefaultAppInitData {
    customisations: CustomisationsInterface;
    authToken: string;
    runtimeFilterParams: string | null;
    runtimeParameterParams: string | null;
    hiddenHomepageModules: HomepageModule[];
    reorderedHomepageModules: string[];
    hostConfig: Record<string, any>;
    hiddenHomeLeftNavItems: string[];
    customVariablesForThirdPartyTools: Record<string, any>;
    hiddenListColumns: ListPageColumns[];
    customActions: CustomAction[];
    interceptTimeout: number | undefined;
    interceptUrls: (string | InterceptedApiType)[];
    embedExpiryInAuthToken:boolean;
    shouldBypassPayloadValidation?:boolean
    useHostEventsV2?:boolean
}

/**
 * Named groups of ThoughtSpot APIs that can be intercepted, for use in
 * `interceptUrls`. Each group expands to the underlying request URLs, so you do
 * not have to list them individually.
 */
export enum InterceptedApiType {
    /**
     * The APIs that fetch the data backing an Answer, including its chart,
     * table, and headline data.
     */
    AnswerData = 'AnswerData',
    /**
     * Intercepts every `fetch` request the embedded application makes, not only
     * the data APIs. This includes authentication, session, and metadata calls,
     * so the handler must respond to requests it does not recognize by passing
     * `execute: true`. Listing this alongside other entries in `interceptUrls`
     * supersedes them.
     */
    ALL = 'ALL',
    /**
     * The APIs that fetch the data backing a Liveboard.
     */
    LiveboardData = 'LiveboardData',
}

export type ApiInterceptFlags = {
    /**
     * Emits `EmbedEvent.OnBeforeGetVizDataIntercept` before the Answer data
     * APIs are called. This is the earlier, narrower form of interception, kept
     * for backward compatibility and implemented on top of
     * `EmbedEvent.ApiIntercept`. Prefer `interceptUrls` with
     * `InterceptedApiType.AnswerData` in new code.
     *
     * Setting this also intercepts the Answer data APIs, so both
     * `EmbedEvent.OnBeforeGetVizDataIntercept` and `EmbedEvent.ApiIntercept`
     * are emitted for those requests.
     *
     * Can be used for Search and App Embed from SDK 1.29.0
     *
     * @version SDK: 1.43.0 | ThoughtSpot: 10.15.0.cl
     */
    isOnBeforeGetVizDataInterceptEnabled?: boolean;
    /**
     * The requests to intercept, given as `InterceptedApiType` groups, absolute
     * URLs, or paths beginning with `/` that are resolved against the
     * ThoughtSpot host. Setting this is what turns interception on.
     *
     * A URL matches only on exact equality with the request's fully resolved
     * URL, query string included, so prefer an `InterceptedApiType` group where
     * one covers the API you need.
     *
     * Each intercepted request pauses and emits `EmbedEvent.ApiIntercept`, then
     * proceeds according to the response passed to that event's responder.
     *
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#embed', {
     *   ...viewConfig,
     *   interceptUrls: [InterceptedApiType.LiveboardData],
     * })
     * ```
     *
     * @version SDK: 1.43.0 | ThoughtSpot: 10.15.0.cl
     */
    interceptUrls?: (string | InterceptedApiType)[];
    /**
     * How long, in milliseconds, an intercepted request waits for the
     * `EmbedEvent.ApiIntercept` responder before it is abandoned. Defaults to
     * 30000. On timeout the request fails and `EmbedEvent.Error` is emitted.
     *
     * @example
     * ```js
     * const embed = new LiveboardEmbed('#embed', {
     *   ...viewConfig,
     *   interceptUrls: [InterceptedApiType.ALL],
     *   interceptTimeout: 1000,
     * })
     * ```
     *
     * @version SDK: 1.43.0 | ThoughtSpot: 10.15.0.cl
     */
    interceptTimeout?: number;
};

/**
 * Object IDs for the embedded component.
 * @version SDK: 1.45.2 | ThoughtSpot: 26.3.0.cl
 */
export interface ObjectIds {
    /**
     * Liveboard ID.
     */
    liveboardId?: string;
    /**
     * Answer ID.
     */
    answerId?: string;
    /**
     * Viz IDs.
     */
    vizIds?: string[];
    /**
     * Data model IDs.
     */
    dataModelIds?: string[];
    /**
     * Modal title.
     */
    modalTitle?: string;
}

export interface ContextObject {
    /**
     * Stack of context objects.
     */
    stack: Array<{
        /**
         * Name of the context object.
         */
        name: string;
        /**
         * Type of the context object.
         */
        type: ContextType;
        /**
         * Object IDs of the context object.
         */
        objectIds: ObjectIds;
    }>;
    /**
     * Current context object.
     */
    currentContext: {
        /**
         * Name of the current context object.
         */
        name: string;
        type: ContextType;
        objectIds: ObjectIds;
    };
}


// ─── Visual Overrides ────────────────────────────────────────────────────────

export interface FontProperties {
    color?: string;
    bold?: boolean;
    italic?: boolean;
    strikeThrough?: boolean;
    underline?: boolean;
}

export interface SolidBackgroundAttrs {
    color?: string;
}

export interface GradientBackgroundAttrs {
    backgroundFormatMidpoint?: number;
    colors?: string[];
    backgroundFormatRange?: number[];
    isAutoScaled?: boolean;
}

/**
 * Data label filter operators
 * @group Visual Overrides
 */
export enum DataLabelFilterOperator {
    /** Greater than */
    GreaterThan = 'GREATER_THAN',
    /** Less than */
    LessThan = 'LESS_THAN',
    /** Greater than or equal to */
    GreaterThanOrEqualTo = 'GREATER_THAN_OR_EQUAL_TO',
    /** Less than or equal to */
    LessThanOrEqualTo = 'LESS_THAN_OR_EQUAL_TO',
    /** Equal to */
    EqualTo = 'EQUAL_TO',
    /** Not equal to */
    NotEqualTo = 'NOT_EQUAL_TO',
}

/**
 * Conditional formatting operators
 * @group Visual Overrides
 */
export enum ConditionalFormattingOperator {
    /** Is equal to */
    Is = 'IS',
    /** Is not equal to */
    IsNot = 'IS_NOT',
    /** Contains */
    Contains = 'CONTAINS',
    /** Does not contain */
    DoesNotContain = 'DOES_NOT_CONTAIN',
    /** Starts with */
    StartsWith = 'STARTS_WITH',
    /** Ends with */
    EndsWith = 'ENDS_WITH',
    /** Greater than */
    GreaterThan = 'GREATER_THAN',
    /** Less than */
    LessThan = 'LESS_THAN',
    /** Greater than or equal to */
    GreaterThanEqualTo = 'GREATER_THAN_EQUAL_TO',
    /** Less than or equal to */
    LessThanEqualTo = 'LESS_THAN_EQUAL_TO',
    /** Equal to */
    EqualTo = 'EQUAL_TO',
    /** Not equal to */
    NotEqualTo = 'NOT_EQUAL_TO',
    /** Is between */
    IsBetween = 'IS_BETWEEN',
    /** Is null */
    IsNull = 'IS_NULL',
    /** Is not null */
    IsNotNull = 'IS_NOT_NULL',
}

/**
 * Background format types for conditional formatting
 * @group Visual Overrides
 */
export enum BackgroundFormatType {
    /** Solid color background */
    Solid = 'SOLID',
    /** Gradient background */
    Gradient = 'GRADIENT',
}

/**
 * Comparison types for conditional formatting
 * @group Visual Overrides
 */
export enum ConditionalFormattingComparisonType {
    /** Value-based comparison */
    ValueBased = 'VALUE_BASED',
    /** Column-based comparison */
    ColumnBased = 'COLUMN_BASED',
    /** Parameter-based comparison */
    ParameterBased = 'PARAMETER_BASED',
}

/**
 * A single conditional formatting rule row
 * @group Visual Overrides
 */
export interface ConditionalFormattingRow {
    /** Comparison operator */
    operator: ConditionalFormattingOperator | string;
    /** Value to compare against */
    value?: string;
    /** Range values for range-based comparisons */
    rangeValues?: { min: number; max: number };
    /** Plot the formatting as a band/area */
    plotAsBand?: boolean;
    /** Highlight this row if the condition is met */
    isHighlightRow?: boolean;
    /** Type of comparison: value-based, column-based, or parameter-based */
    comparisonType?: ConditionalFormattingComparisonType | string;
    /** Column ID to apply the formatting to (left-hand side) */
    lhsColumnId?: string;
    /** Column name to compare against (right-hand side) */
    columnToCompare?: string;
    /** Parameter ID to compare against */
    comparisonParameterId?: string;
    /** Font properties to apply (color, bold, italic, etc.) */
    fontProperties?: FontProperties;
    /** Background format type: solid color or gradient */
    backgroundFormatType?: BackgroundFormatType | string;
    /** Solid background color attributes */
    solidBackgroundAttrs?: SolidBackgroundAttrs;
    /** Gradient background attributes */
    gradientBackgroundAttrs?: GradientBackgroundAttrs;
}

/**
 * Conditional formatting configuration
 * @group Visual Overrides
 */
export interface ConditionalFormatting {
    /** Array of conditional formatting rules */
    rows?: ConditionalFormattingRow[];
}

/**
 * Color palette for charts
 * @group Visual Overrides
 */
export interface ColorPalette {
    /** Array of color values (hex codes or color names) */
    colors?: string[];
}

/**
 * Legend position options
 * @group Visual Overrides
 */
export enum LegendPosition {
    /** Position legend at the top */
    Top = 'top',
    /** Position legend at the bottom */
    Bottom = 'bottom',
    /** Position legend on the left */
    Left = 'left',
    /** Position legend on the right */
    Right = 'right',
}

/**
 * Table theme options
 * @group Visual Overrides
 */
export enum TableTheme {
    /** Outline theme */
    Outline = 'OUTLINE',
    /** Row theme */
    Row = 'ROW',
    /** Zebra theme */
    Zebra = 'ZEBRA',
}

/**
 * Table content density options
 * @group Visual Overrides
 */
export enum TableContentDensity {
    /** Regular density */
    Regular = 'REGULAR',
    /** Compact density */
    Compact = 'COMPACT',
}

/**
 * Chart legend configuration
 * @group Visual Overrides
 */
export interface ChartLegend {
    /** Show or hide the legend */
    show?: boolean;
    /** Position of the legend */
    position?: LegendPosition | string;
    /** Color palette to use for legend colors */
    colorPalette?: ColorPalette;
}

/**
 * Filter for data labels
 * @group Visual Overrides
 */
export interface DataLabelFilter {
    /** Filter threshold value */
    value?: number;
    /** Filter operator */
    operator?: DataLabelFilterOperator | string;
}

/**
 * Data label configuration for a specific column
 * @group Visual Overrides
 */
export interface ColumnDataLabel {
    /** Column name to apply data label overrides to */
    name: string;
    /** Show or hide data labels for this column */
    visible?: boolean;
    /** Filter to apply to data labels */
    filter?: DataLabelFilter | null;
}

/**
 * Chart data label configuration
 * @group Visual Overrides
 */
export interface ChartDataLabel {
    /** Show labels for all data points */
    allLabels?: boolean;
    /** Show labels for stacked values */
    stackLabels?: boolean;
    /** Per-column data label configurations */
    columnDataLabel?: ColumnDataLabel[];
}

/**
 * Chart summaries and totals configuration
 * @group Visual Overrides
 */
export interface ChartSummaries {
    /** Show row totals */
    showRowTotals?: boolean;
    /** Show column totals */
    showColumnTotals?: boolean;
    /** Show row grand totals */
    showRowGrandTotals?: boolean;
    /** Show column grand totals */
    showColumnGrandTotals?: boolean;
}

/**
 * Gridline configuration
 * @group Visual Overrides
 */
export interface GridLine {
    /** Show vertical gridlines */
    x?: boolean;
    /** Show horizontal gridlines */
    y?: boolean;
}

/**
 * Chart display configuration
 * @group Visual Overrides
 */
export interface ChartDisplay {
    /** Summary and totals configuration */
    summaries?: ChartSummaries;
    /** Show regression line on chart */
    regressionLine?: boolean;
    /** Gridline visibility configuration */
    gridLine?: GridLine;
}

/**
 * Y-axis range configuration
 * @group Visual Overrides
 */
export interface YAxisRange {
    /** Minimum value for Y-axis */
    min?: number;
    /** Maximum value for Y-axis */
    max?: number;
}

/**
 * Chart axis configuration
 * @group Visual Overrides
 */
export interface ChartAxis {
    /** Column names to link to this axis */
    linkedColumns?: string[];
    /** Show the axis name */
    showName?: boolean;
    /** Show the axis label values */
    showLabelValue?: boolean;
    /** Y-axis range configuration */
    yAxisRange?: YAxisRange;
}

/**
 * Chart column override configuration
 * @group Visual Overrides
 */
export interface ChartColumn {
    /** Column name to apply overrides to */
    name: string;
    /** Color for the column (hex code) */
    color?: string;
    /** Conditional formatting rules to apply to the column */
    conditionalFormatting?: ConditionalFormatting;
}

/**
 * Chart visualization overrides
 * @group Visual Overrides
 */
export interface ChartOverrides {
    /** Legend configuration */
    legend?: ChartLegend;
    /** Data label configuration */
    dataLabel?: ChartDataLabel;
    /** Display properties (summaries, regression line, gridlines) */
    display?: ChartDisplay;
    /** Per-axis configurations */
    axis?: ChartAxis[];
    /** Per-column configurations */
    columns?: ChartColumn[];
    /** Update mask paths for partial updates */
    updateMaskPaths?: string[];
}

/**
 * Table column override configuration
 * @group Visual Overrides
 */
export interface TableColumn {
    /**
     * Name of the column to apply overrides to
     */
    name: string;
    /**
     * Enable or disable text wrapping for the column
     */
    wrapText?: boolean;
    /**
     * Show or hide the column
     */
    show?: boolean;
    /**
     * Conditional formatting rules to apply to the column
     */
    conditionalFormatting?: ConditionalFormatting;
}

/**
 * Table display configuration
 * @group Visual Overrides
 */
export interface TableDisplay {
    /** Table theme */
    tableTheme?: TableTheme | string;
    /** Table content density */
    tableContentDensity?: TableContentDensity | string;
}

/**
 * Column summary visibility configuration
 * @group Visual Overrides
 */
export interface ColumnSummaryVisibility {
    /** Column ID to control summary visibility for */
    columnId: string;
    /** Show or hide summary for this column */
    visible: boolean;
}

/**
 * Display summary configuration
 * @group Visual Overrides
 */
export interface DisplaySummaryConfig {
    /** Show all column summaries by default */
    showAllSummaries?: boolean;
    /** Per-column summary visibility overrides */
    columnVisibility?: ColumnSummaryVisibility[];
}

/**
 * Table visualization overrides
 * @group Visual Overrides
 */
export interface TableOverrides {
    /** Per-column configurations (properties, conditional formatting) */
    columns?: TableColumn[];
    /** Table display properties (theme, density) */
    display?: TableDisplay;
    /** Summary/headline column visibility configuration */
    displaySummaryConfig?: DisplaySummaryConfig;
    /** Update mask paths for partial updates */
    updateMaskPaths?: string[];
}

/**
 * Visualization overrides to customize chart and table rendering
 * within embedded ThoughtSpot components.
 *
 * @group Visual Overrides
 * @example
 * ```js
 * const embed = new AppEmbed('#tsEmbed', {
 *   visualOverrides: {
 *     chart: {
 *       legend: { show: true, position: 'bottom' },
 *       columns: [{ name: 'Revenue', color: '#1f77b4' }],
 *     },
 *     table: {
 *       display: { tableTheme: 'ZEBRA', tableContentDensity: 'COMPACT' },
 *     },
 *   },
 * });
 * ```
 */
export interface VisualizationOverrides {
    /** Chart visualization overrides */
    chart?: ChartOverrides;
    /** Table visualization overrides */
    table?: TableOverrides;
}

/**
 * The configuration object for the full-height behavior shared by the
 * Liveboard and app embeds.
 *
 * When `fullHeight` is enabled the SDK resizes the embed container to match the
 * height reported by the ThoughtSpot app, and — when lazy loading is also
 * enabled — keeps the app informed of the portion of the embed that is
 * currently visible so that visualizations load on demand.
 */
export interface FullHeightViewConfig {
    /**
     * If set to true, the embedded object container dynamically resizes
     * according to the height of the Liveboard.
     *
     * **Note**:  Using fullHeight loads all visualizations on the
     * Liveboard simultaneously, which results in multiple warehouse
     * queries and potentially a longer wait for the topmost
     * visualizations to display on the screen.
     * Setting `fullHeight` to `false` fetches visualizations
     * incrementally as users scroll the page to view the charts and tables.
     *
     * From SDK 1.52.0, enabling `fullHeight` also turns on
     * {@link lazyLoadingForFullHeight} and
     * {@link enableScrollableContainerLazyLoading}, so visualizations load as
     * they scroll into view. Set either flag to `false` to opt out.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.1.0 | ThoughtSpot: ts7.may.cl, 7.2.1
     * @example
     * ```js
     * // Replace <EmbedComponent> with the embed component name.
     * // For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#embed', {
     *   ... // other view config
     *   fullHeight: true,
     * });
     * ```
     */
    fullHeight?: boolean;
    /**
     * This is the minimum height (in pixels) for a full-height Liveboard.
     * Setting this height helps resolve issues with empty Liveboards and
     * other screens navigable from a Liveboard.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.44.2 | ThoughtSpot: 10.15.0.cl
     * @default 500
     * @example
     * ```js
     * // Replace <EmbedComponent> with the embed component name.
     * // For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#embed', {
     *   ... // other view config
     *   fullHeight: true,
     *   minimumHeight: 600,
     * });
     * ```
     */
    minimumHeight?: number;
    /**
     * This is the minimum height (in pixels) for a full-height Liveboard.
     * Setting this height helps resolve issues with empty Liveboards and
     * other screens navigable from a Liveboard.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @version SDK: 1.5.0 | ThoughtSpot: ts7.oct.cl, 7.2.1
     * @deprecated Use `minimumHeight` instead.
     * @default 500
     * @example
     * ```js
     * // Replace <EmbedComponent> with the embed component name.
     * // For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#embed', {
     *   ... // other view config
     *   fullHeight: true,
     *   defaultHeight: 600,
     * });
     * ```
     */
    defaultHeight?: number;
    /**
     * Loads visualizations only as they scroll into the viewport, instead of
     * loading the whole full-height Liveboard at once.
     *
     * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
     * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
     * set explicitly. Set it to `false` to load every visualization upfront.
     * The flag has no effect unless `fullHeight` is enabled.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @type {boolean}
     * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
     * @default true when `fullHeight` is enabled, from SDK 1.52.0
     * @example
     * ```js
     * // Replace <EmbedComponent> with the embed component name.
     * // For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#embed-container', {
     *    // ...other options
     *    fullHeight: true,
     *    lazyLoadingForFullHeight: true,
     * })
     * ```
     */
    lazyLoadingForFullHeight?: boolean;
    /**
     * How far outside the viewport a visualization starts loading, when
     * {@link lazyLoadingForFullHeight} is enabled.
     *
     * For example, if the margin is set to '10px',
     * the visualization will be loaded 10px before its top edge is visible in the
     * viewport.
     *
     * The format is similar to CSS margin, so `'500px 0px'` extends the
     * prefetch 500px above and below the viewport and not sideways. Accepted
     * units are `px`, `em`, `rem`, `%`, `vh` and `vw`, plus bare `0` and
     * `auto`; an invalid value is logged and ignored.
     *
     * From SDK 1.52.0 this defaults to `'500px 0px'` — roughly one
     * visualization ahead of the scroll position, so a chart has usually
     * finished loading by the time it scrolls into view. Use a smaller margin
     * to cut warehouse queries further, or `'0px'` to load a visualization
     * only once it is actually visible.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @type {string}
     * @version SDK: 1.40.0 | ThoughtSpot: 10.12.0.cl
     * @default '500px 0px' when `fullHeight` is enabled, from SDK 1.52.0
     * @example
     * ```js
     * // Replace <EmbedComponent> with the embed component name.
     * // For example, AppEmbed or LiveboardEmbed
     * const embed = new <EmbedComponent>('#embed-container', {
     *    // ...other options
     *    fullHeight: true,
     *    lazyLoadingForFullHeight: true,
     *    // With 0px, the visualization only starts loading once it is
     *    // visible in the viewport.
     *    lazyLoadingMargin: '0px',
     * })
     * ```
     */
    lazyLoadingMargin?: string;
    /**
     * Computes the visible region of the embed against its scrollable and
     * clipping ancestors, instead of treating the browser window as the only
     * viewport, and tracks scroll and resize on those ancestors.
     *
     * From SDK 1.52.0 this is enabled automatically whenever `fullHeight` is
     * `true`. On SDK 1.51.0 and earlier it defaulted to `false` and had to be
     * set explicitly. Set it to `false` when the page scrolls with the window
     * and the embed has no clipping ancestor, to skip the extra ancestor
     * tracking.
     *
     * Supported embed types: `LiveboardEmbed`, `AppEmbed`
     * @type {boolean}
     * @default true when `fullHeight` is enabled, from SDK 1.52.0
     */
    enableScrollableContainerLazyLoading?: boolean;
}