@thoughtspot/visual-embed-sdk 1.47.2 → 1.48.0

package/src/types.ts

@@ -926,9 +926,10 @@ export interface BaseViewConfig extends ApiInterceptFlags {
     styleSheet__unstable?: string;
     /**
      * The list of actions to disable from the primary menu, more menu
-     * (...), and the contextual menu. These actions will be disabled
-     * for the user.
-     * Use this to disable actions.
+     * (...), 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
@@ -959,9 +960,10 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      */
     disabledActionReason?: string;
     /**
-     * The list of actions to hide from the embedded view.
-     * These actions will be hidden from the user.
-     * Use this to hide an action.
+     * 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
@@ -980,9 +982,8 @@ export interface BaseViewConfig extends ApiInterceptFlags {
      * 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 to hide all actions except the ones you want to show.
-     *
-     * Use either this or hiddenActions.
+     * 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
@@ -1437,6 +1438,7 @@ export interface BaseViewConfig extends ApiInterceptFlags {
     /**
      * 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', {
@@ -1994,6 +1996,22 @@ export interface LiveboardAppEmbedViewConfig {
      * ```
      */
     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
@@ -5862,6 +5880,7 @@ export enum Param {
     ShowLiveboardTitle = 'showLiveboardTitle',
     ShowMaskedFilterChip = 'showMaskedFilterChip',
     IsLiveboardMasterpiecesEnabled = 'isLiveboardMasterpiecesEnabled',
+    EnableNewChartLibrary = 'muzeChartPhase1EnabledGA',
     HiddenTabs = 'hideTabs',
     VisibleTabs = 'visibleTabs',
     HideTabPanel = 'hideTabPanel',
@@ -5943,10 +5962,14 @@ export enum Param {
 /**
  * ThoughtSpot application pages include actions and menu commands
  * for various user-initiated operations. These actions are represented
- * as enumeration members in the SDK. To show, hide, or disable
- * specific actions in the embedded view, define the Action
- * enumeration members in the `disabledActions`, `visibleActions`,
- * or `hiddenActions` array.
+ * 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', {
@@ -6797,6 +6820,26 @@ export enum Action {
      * @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
      */
@@ -8076,6 +8119,9 @@ export interface DefaultAppInitData {
     customActions: CustomAction[];
     interceptTimeout: number | undefined;
     interceptUrls: (string | InterceptedApiType)[];
+    embedExpiryInAuthToken:boolean;
+    shouldBypassPayloadValidation?:boolean
+    useHostEventsV2?:boolean
 }
 
 /**
@@ -8197,3 +8243,440 @@ export interface ContextObject {
         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;
+}