@thoughtspot/visual-embed-sdk 1.47.2 → 1.48.0

package/dist/visual-embed-sdk-react.d.ts

@@ -1847,9 +1847,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
@@ -1880,9 +1881,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
@@ -1901,9 +1903,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
@@ -2357,6 +2358,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', {
@@ -2906,6 +2908,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 extends BaseViewConfig, SearchLiveboardCommonViewConfig, HomePageConfig, LiveboardAppEmbedViewConfig {
 }
@@ -6628,10 +6646,14 @@ export declare enum HostEvent {
 /**
  * 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', {
@@ -7478,6 +7500,26 @@ export declare 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
 	 */
@@ -8585,6 +8627,9 @@ export interface DefaultAppInitData {
 	customActions: CustomAction[];
 	interceptTimeout: number | undefined;
 	interceptUrls: (string | InterceptedApiType)[];
+	embedExpiryInAuthToken: boolean;
+	shouldBypassPayloadValidation?: boolean;
+	useHostEventsV2?: boolean;
 }
 declare enum InterceptedApiType {
 	/**
@@ -8699,6 +8744,385 @@ export interface ContextObject {
 		objectIds: ObjectIds;
 	};
 }
+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;
+}
+declare 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"
+}
+declare 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"
+}
+declare enum BackgroundFormatType {
+	/** Solid color background */
+	Solid = "SOLID",
+	/** Gradient background */
+	Gradient = "GRADIENT"
+}
+declare 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[];
+}
+declare 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"
+}
+declare enum TableTheme {
+	/** Outline theme */
+	Outline = "OUTLINE",
+	/** Row theme */
+	Row = "ROW",
+	/** Zebra theme */
+	Zebra = "ZEBRA"
+}
+declare 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;
+}
 declare enum AuthFailureType {
 	/**
 	 * Authentication failed in the SDK authentication flow.
@@ -9317,6 +9741,7 @@ declare class TsEmbed {
 	 * @returns
 	 */
 	protected createEmbedEventResponder: (eventPort: MessagePort | void, eventType: EmbedEvent) => (payload: any) => void;
+	private shouldSkipEvent;
 	/**
 	 * Executes all registered event handlers for a particular event type
 	 * @param eventType The event type
@@ -9891,9 +10316,32 @@ export interface SearchViewConfig extends SearchLiveboardCommonViewConfig, Omit<
 	 * ```
 	 */
 	focusSearchBarOnRender?: boolean;
+	/**
+	 * Enable or disable Muze chart phase 1 GA
+	 *
+	 * Supported embed types: `SearchEmbed`
+	 * @version SDK: 1.49.0 | ThoughtSpot Cloud: 26.6.0.cl
+	 * @default false
+	 * @example
+	 * ```js
+	 * const embed = new SearchEmbed('#tsEmbed', {
+	 *    ... // other embed view config
+	 *    newChartsLibrary: true,
+	 * })
+	 * ```
+	 */
+	newChartsLibrary?: boolean;
+	/**
+	 * Visual overrides to customize the chart or table properties.
+	 * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
+	 */
+	visualOverrides?: VisualizationOverrides;
 }
 export interface SearchAppInitData extends DefaultAppInitData {
 	searchOptions?: SearchOptions;
+	embedParams?: {
+		visualOverridesParams?: VisualizationOverrides | null;
+	};
 }
 declare class SearchEmbed extends TsEmbed {
 	/**
@@ -10391,6 +10839,7 @@ export interface ConversationViewConfig extends SpotterEmbedViewConfig {
 export interface SpotterAppInitData extends DefaultAppInitData {
 	embedParams?: {
 		spotterSidebarConfig?: SpotterSidebarViewConfig;
+		visualOverridesParams?: VisualizationOverrides | null;
 	};
 }
 declare class SpotterEmbed extends TsEmbed {
@@ -10956,7 +11405,7 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	/**
 	 * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
 	 * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
-	 * This feature is GA from version 26.5.0.cl and is enabled by default on embed deployments.
+	 * This feature is GA from version 26.5.0.cl. It is disabled by default in embed deployments.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}
@@ -11160,6 +11609,11 @@ export interface AppViewConfig extends AllEmbedViewConfig {
 	 * ```
 	 */
 	enableLiveboardDataCache?: boolean;
+	/**
+	 * Visual overrides to customize the chart or table properties.
+	 * @version SDK: 1.49.0 | ThoughtSpot: 26.6.0.cl
+	 */
+	visualOverrides?: VisualizationOverrides;
 }
 /**
  * APP_INIT data shape for AppEmbed.
@@ -11607,7 +12061,7 @@ export interface LiveboardViewConfig extends BaseViewConfig, SearchLiveboardComm
 	/**
 	 * Enables the 'what you see is what you get' PDF export for Liveboards. Each tab is rendered on a single page
 	 * following the exact UI layout, instead of splitting visualizations across multiple A4 pages.
-	 * This feature is GA from version 26.5.0.cl and is enabled by default on embed deployments.
+	 * This feature is GA from version 26.5.0.cl. It is disabled by default in embed deployments.
 	 *
 	 * Supported embed types: `AppEmbed`, `LiveboardEmbed`
 	 * @type {boolean}