Merge pull request #333 from thoughtspot/main

10-11-0 doc publication

Author: ShashiSubramanya

modules/ROOT/pages/api-changelog.adoc

@@ -8,6 +8,85 @@
 
 This changelog lists only the changes introduced in the Visual Embed SDK. For information about new features and enhancements available for embedded analytics, see xref:whats-new.adoc[What's New].
 
+== Version 1.40.0, July 2025
+
+[width="100%" cols="1,4"]
+|====
+|[tag greenBackground]#NEW FEATURE#  a| *Fullscreen presentation mode controls for embedded Liveboards and visualizations* +
+Developers can now control whether a visualization or Liveboard can be presented in full screen mode using the `disableFullscreenPresentation` attribute. By default, the full screen mode is disabled on embedded Liveboards and visualizations.
+|[tag greenBackground]#NEW FEATURE#  a| *PDF download settings* +
+Developers can now control the display of *Include cover page* and *Include filter page(s)* options on the Download PDF dialog for Liveboards. The *Include cover page* and *Include filter page(s)* options are disabled by default on ThoughtSpot instances. When this feature is enabled, developers can use the `coverAndFilterOptionInPDF` attribute to show or hide these options for the Liveboard users in their embedding app.
+
+|[tag greenBackground]#NEW FEATURE# a| *Parameter for overriding a default primary action* +
+
+If Spotter is enabled on your instance, the *Spotter* button appears by default as the primary action on embedded Liveboard charts; if Spotter is not enabled, the *Explore* button is set as the primary action. If you want to replace the primary action with a different action, you can now use the `primaryAction` attribute.
+
+For more information, see xref:embed-actions.adoc#_override_default_primary_actions[Override default primary action].
+
+|[tag greenBackground]#NEW FEATURE# a| *Full application embed experience enhancements* +
+
+The SDK now includes the `hideObjectSearch` property, which allows developers to hide the object search button in the navigation bar when embedding the full application.
+
+|[tag greenBackground]#NEW FEATURE#  a| *Host events* +
+
+In this version, the SDK introduces the following host event handlers:
+
+- `HostEvent.ExitPresentMode` +
+Triggers the exit action that allows users to exit the Liveboard or visualization present mode.
+- `HostEvent.SpotterSearch` +
+Triggers a search operation for the specified query string Spotter embed.
+- `HostEvent.PreviewSpotterData` +
+Triggers the *Preview data* action that shows the data used for Spotter conversations.
+- `HostEvent.ResetSpotterConversation` +
+Triggers the *Reset* action to reset a Spotter conversation.
+- `HostEvent.EditLastPrompt` +
+Triggers the edit prompt action.
+- `HostEvent.DeleteLastPrompt` +
+Triggers the delete prompt action.
+
+For more information, see xref:HostEvent.adoc[HostEvent].
+
+|[tag greenBackground]#NEW FEATURE# a|*Events support for Spotter embed*
+
+You can now use the following host events in Spotter embed:
+
+- `HostEvent.DownloadAsCsv`
+- `HostEvent.DownloadAsPng`
+- `HostEvent.DownloadAsXlsx`
+- `HostEvent.Edit`
+//- `HostEvent.GetParameters`
+//- `HostEvent.GetTML`
+- `HostEvent.MakeACopy`
+- `HostEvent.Pin`
+- `HostEvent.Save`
+
+For more information, see xref:HostEvent.adoc[HostEvent].
+
+|[tag greenBackground]#NEW FEATURE# a| *Lazy loading with full height*
+
+The SDK introduces `lazyLoadingForFullHeight` parameter, which enables progressive loading of visualizations on an  embedded Liveboard.
+This parameter works in conjunction with the `fullHeight` attribute. When both these attributes are enabled, only the visualizations in the current viewport are loaded initially, while the other visualizations load as the user scrolls the Liveboard page.
+
+[NOTE]
+====
+To use these attributes effectively in embedded applications, your ThoughtSpot instance must be upgraded to version 10.12.0.cl or later.
+====
+|====
+
+////
+
+TBD 10.12 events
+
+- `HostEvent.AnswerChartSwitcher`
+- `HostEvent.AskSpotter`
+- `HostEvent.DeleteLastPrompt`
+- `HostEvent.EditLastPrompt`
+- `HostEvent.PreviewSpotterData`
+- `HostEvent.ResetSpotterConversation`
+- `HostEvent.SpotterSearch`
+
+////
+
 == Version 1.39.0, July 2025
 
 [width="100%" cols="1,4"]
@@ -31,6 +110,54 @@ For ThoughtSpot instances that have the new Spotter feedback and coaching workfl
 [NOTE]
 The **Add to Coaching** feature is currently in beta and is turned off by default on embed deployments. To enable this feature on your instance, contact ThoughtSpot Support.
 
+|[tag greenBackground]#NEW FEATURE# a|*Events support for Spotter embed*
+
+New embed events::
+
+- `EmbedEvent.ExitPresentMode` +
+Emits when a user exits the Liveboard or visualization presentation mode.
+- `EmbedEvent.LastPromptDeleted` +
+Emits when a query prompt in Spotter embed is deleted.
+- `EmbedEvent.LastPromptEdited` +
+Emits when a query prompt in Spotter embed is edited.
+- `EmbedEvent.ResetSpotterConversation` +
+Emits when a Spotter query is reset.
+- `EmbedEvent.PreviewSpotterData` +
+Emits when a user clicks the Preview data button in the Spotter conversation panel.
+- `EmbedEvent.SpotterQueryTriggered`
+Emits when a Spotter query is triggered.
+
+The following embed events are also supported in Spotter embed:
+
+- `EmbedEvent.AddRemoveColumns`
+- `EmbedEvent.AnswerChartSwitcher`
+- `EmbedEvent.AuthExpire`
+- `EmbedEvent.AuthInit`
+- `EmbedEvent.CopyToClipboard`
+- `EmbedEvent.CustomAction`
+- `EmbedEvent.Data`
+- `EmbedEvent.DataSourceSelected`
+- `EmbedEvent.DialogClose`
+- `EmbedEvent.DialogOpen`
+- `EmbedEvent.Download`
+- `EmbedEvent.DownloadAsCsv`
+- `EmbedEvent.DownloadAsPng`
+- `EmbedEvent.DownloadAsXlsx`
+- `EmbedEvent.DrillDown`
+- `EmbedEvent.DrillExclude`
+- `EmbedEvent.DrillInclude`
+- `EmbedEvent.Edit`
+- `EmbedEvent.Error`
+- `EmbedEvent.Load`
+- `EmbedEvent.Pin`
+- `EmbedEvent.Save`
+- `EmbedEvent.TableVizRendered`
+- `EmbedEvent.VizPointClick`
+- `EmbedEvent.VizPointDoubleClick`
+- `EmbedEvent.VizPointRightClick`
+
+For more information, see xref:EmbedEvent.adoc[EmbedEvent].
+
 |====
 
 == Version 1.38.0, June 2025

modules/ROOT/pages/common/nav.adoc

@@ -62,7 +62,7 @@
 *** Embed analytics
 **** link:{{navprefix}}/embed-liveboard[Embed a Liveboard]
 **** link:{{navprefix}}/embed-a-viz[Embed a visualization]
-*** Embed natural language search
+*** Embed AI Search and Analytics
 **** link:{{navprefix}}/embed-spotter[Embed Spotter]
 **** link:{{navprefix}}/tutorials/spotter/integrate-into-chatbot[Integrate Spotter interface into a Chatbot]
 **** link:{{navprefix}}/embed-nls[Embed Natural Language Search (legacy interface)]

modules/ROOT/pages/developer-playground.adoc

@@ -165,7 +165,7 @@ searchOptions: {
 }
 ----
 
-a|**Hide Sage Answer header**
+a|**Hide AI-Answer header**
 
 Hides the Answer header container.
 

modules/ROOT/pages/development-and-deployment.adoc

@@ -21,6 +21,11 @@ xref:orgs.adoc[Orgs] are fully separated tenants on a single ThoughtSpot instanc
 
 Once your environments are configured, you can xref:version_control.adoc#moving-tml-changes-between-environments[move data models and content] from the initial "dev environment" to any other environment using the xref:git-rest-api-guide.adoc[Git integration REST APIs].
 
+[NOTE]
+====
+ThoughtSpot does not recommend TML export and import across different versions of ThoughtSpot application because the TML syntax, supported features, and object schemas can vary between releases and can sometimes lead to compatibility issues and validation errors.
+====
+
 ////
 If you have used ThoughtSpot for a long time and are enabling Orgs for the first time, please see xref:moving-to-orgs.adoc[moving to Orgs from single-tenant ThoughtSpot instance].
 ////