Site ux and other changes

gatsby-node.js

@@ -6,6 +6,62 @@ const {
 } = require('./src/configs/doc-configs');
 const { getDocLinkFromEdge } = require('./src/utils/gatsby-utils.js');
 
+/* ── Build-time Markdown generation ───────────────────────────────────────
+ * For every asciidoc node, convert the already-generated HTML to clean
+ * Markdown using cheerio (DOM pre-processing) + turndown (HTML→MD).
+ * The result is stored as `fields.markdownBody` on each node and exposed
+ * in GraphQL so CopyPageDropdown can use it instead of scraping the DOM.
+ */
+exports.onCreateNode = ({ node, actions }) => {
+    if (node.internal.type !== 'Asciidoc') return;
+
+    const { createNodeField } = actions;
+    const TurndownService = require('turndown');
+    const cheerio = require('cheerio');
+
+    const html = node.html || '';
+    const title = node.document?.title || node.pageAttributes?.title || '';
+
+    /* Load HTML into cheerio for pre-processing */
+    const $ = cheerio.load(html, { decodeEntities: false });
+
+    /* Remove anchor icon links that Asciidoctor injects next to headings */
+    $('a.anchor').remove();
+
+    /* Remove the embedded TOC — it adds noise to Markdown */
+    $('#toc').remove();
+
+    /* Convert admonition tables to readable text blocks */
+    $('.admonitionblock').each((_, el) => {
+        const type = $(el).attr('class').match(/\b(note|tip|warning|caution|important)\b/i)?.[1]?.toUpperCase() || 'NOTE';
+        const content = $(el).find('td.content').text().trim();
+        $(el).replaceWith(`<blockquote><p><strong>${type}:</strong> ${content}</p></blockquote>`);
+    });
+
+    /* Get the cleaned HTML */
+    const cleanedHtml = $('body').html() || '';
+
+    /* Configure turndown */
+    const td = new TurndownService({
+        headingStyle: 'atx',
+        bulletListMarker: '-',
+        codeBlockStyle: 'fenced',
+        fence: '```',
+    });
+
+    /* GFM table plugin — renders tables as proper Markdown pipe tables */
+    const { tables } = require('turndown-plugin-gfm');
+    td.use(tables);
+
+    const markdownBody = td.turndown(cleanedHtml);
+
+    createNodeField({
+        node,
+        name: 'markdownBody',
+        value: markdownBody,
+    });
+};
+
 exports.onPostBuild = () => {
     fsExtra.copyFileSync(
         `${__dirname}/robots.txt`,
@@ -39,12 +95,23 @@ exports.createPages = async function ({ actions, graphql }) {
     `);
 
     const namePageIdMap = {};
+    // Collect per-category nav HTMLs keyed by category name (pageid minus 'nav-' prefix)
+    const navMap = {};
+    const NAV_PARTIAL_PREFIX = 'nav-';
+
     data.allAsciidoc.edges.forEach((e) => {
         const {
             sourceInstanceName: sourceName,
             relativePath: relPath,
         } = e.node.parent;
         const pageId = e.node.pageAttributes.pageid;
+
+        // Collect nav-* files into the navMap (not content pages)
+        if (pageId && pageId.startsWith(NAV_PARTIAL_PREFIX)) {
+            navMap[pageId.slice(NAV_PARTIAL_PREFIX.length)] = e.node.html;
+            return;
+        }
+
         if (sourceName === 'tutorials') {
             const relPathSplit = relPath.split('/');
             const pageIdSplit = pageId.split('__');
@@ -66,13 +133,16 @@ exports.createPages = async function ({ actions, graphql }) {
     data.allAsciidoc.edges.forEach((edge) => {
         const { pageid: pageId } = edge.node.pageAttributes;
 
+        // Skip nav partial files — they are sidebar data, not content pages
+        if (pageId && pageId.startsWith(NAV_PARTIAL_PREFIX)) return;
+
         const docPath = getDocLinkFromEdge(edge);
         actions.createPage({
             path: docPath,
             component: require.resolve(
                 './src/components/DevDocTemplate/index.tsx',
             ),
-            context: { pageId, navId: DOC_NAV_PAGE_ID, namePageIdMap },
+            context: { pageId, navId: DOC_NAV_PAGE_ID, navMap, namePageIdMap },
         });
 
         if (pageId === 'introduction') {
@@ -81,7 +151,7 @@ exports.createPages = async function ({ actions, graphql }) {
                 component: require.resolve(
                     './src/components/DevDocTemplate/index.tsx',
                 ),
-                context: { pageId, navId: DOC_NAV_PAGE_ID, namePageIdMap },
+                context: { pageId, navId: DOC_NAV_PAGE_ID, navMap, namePageIdMap },
             });
         }
     });

modules/ROOT/pages/ai-integration-options.adoc

@@ -1,4 +1,4 @@
-= ThoughtSpot AI analytics integration
+= AI analytics integration
 :toc: true
 :toclevels: 3
 

modules/ROOT/pages/common/nav-embedding.adoc

@@ -0,0 +1,177 @@
+
+:page-pageid: nav-embedding
+:page-description: Embedding navigation
+
+[navSection]
+
+[.sidebar-title]
+Embed ThoughtSpot in a web app
+
+* link:{{navprefix}}/getting-started[Embed with Visual Embed SDK]
+* link:{{navprefix}}/tsembed[Quickstart guide]
+* link:{{navprefix}}/embed-ai-search-analytics[Embed AI Search and Analytics]
+** link:{{navprefix}}/embed-spotter[Embed Spotter experience]
+** link:{{navprefix}}/embed-spotter-agent[Embed Spotter Agent]
+* link:{{navprefix}}/embed-liveboard[Embed Analytics]
+** link:{{navprefix}}/embed-liveboard[Embed a Liveboard]
+** link:{{navprefix}}/embed-a-viz[Embed a visualization]
+* link:{{navprefix}}/full-embed[Embed full application]
+** link:{{navprefix}}/full-app-customize[Customize your embed]
+** link:{{navprefix}}/customize-nav-controls[Customize navigation panels]
+** link:{{navprefix}}/set-default-page[Customize default page and navigation path]
+** link:{{navprefix}}/customize-homepage-experience[Customize home page experience]
+* Embed token-based Search
+** link:{{navprefix}}/search-embed[Embed Search]
+** link:{{navprefix}}/embed-searchbar[Embed search bar]
+* link:{{navprefix}}/react-app-embed[Embed with React components]
+
+[.sidebar-title]
+Embed ThoughtSpot in a mobile app
+
+* link:{{navprefix}}/mobile-embed[Overview]
+* link:{{navprefix}}/embed-ts-mobile-react-native[React Native SDK]
+* link:{{navprefix}}/embed-ts-flutter[Flutter embed SDK]
+* link:{{navprefix}}/embed-ts-swift[Swift Embed SDK]
+* link:{{navprefix}}/embed-ts-android[Android Embed SDK]
+
+[.sidebar-title]
+Embed without SDK
+
+** link:{{navprefix}}/embed-without-sdk[Embed without SDK]
+** link:{{navprefix}}/custom-viz-rest-api[Create a custom visualization]
+
+[.sidebar-title]
+Customize and integrate
+
+* link:{{navprefix}}/style-customization[Customize UI layout and styles]
+** link:{{navprefix}}/customize-style[Customize basic styles]
+** link:{{navprefix}}/custom-css[CSS customization framework]
+** link:{{navprefix}}/theme-builder-doc[Theme builder]
+** link:{{navprefix}}/customize-icons[Customize icons]
+** link:{{navprefix}}/customize-text[Customize text strings]
+** link:{{navprefix}}/css-variables-reference[CSS variables reference]
+
+* link:{{navprefix}}/filters-overview[Filters overview]
+** link:{{navprefix}}/runtime-overrides[Runtime overrides]
+** link:{{navprefix}}/runtime-filters[Runtime filters]
+** link:{{navprefix}}/runtime-params[Runtime Parameters]
+* link:{{navprefix}}/action-config[Customize menus]
+** link:{{navprefix}}/actions[Action IDs in the SDK]
+* link:{{navprefix}}/events-app-integration[Events and app interactions]
+** link:{{navprefix}}/embed-events[Using embed events]
+** link:{{navprefix}}/host-events[Using host events]
+** link:{{navprefix}}/context-aware-event-routing[Context-based execution of host events]
+** link:{{navprefix}}/hostEventsV2-migration[Migrating from Host Event v1 to Host Events v2 framework]
+** link:{{navprefix}}/api-search-intercept[API intercept and data fetch requests]
+
+* link:{{navprefix}}/custom-action-intro[Custom actions]
+** link:{{navprefix}}/customize-actions[Custom actions through the UI]
+*** link:{{navprefix}}/custom-action-url[URL actions]
+*** link:{{navprefix}}/custom-action-callback[Callback actions]
+*** link:{{navprefix}}/edit-custom-action[Set the position of a custom action]
+*** link:{{navprefix}}/add-action-viz[Add a local action to a visualization]
+*** link:{{navprefix}}/add-action-worksheet[Add a local action to a model]
+** link:{{navprefix}}/code-based-custom-action[Code based custom actions]
+** link:{{navprefix}}/custom-action-payload[Callback response payload]
+
+* link:{{navprefix}}/customize-links[Customize links]
+* link:{{navprefix}}/set-locale[Customize locale]
+* link:{{navprefix}}/custom-domain-config[Custom domain configuration]
+* link:{{navprefix}}/customize-emails[Customize onboarding settings]
+* link:{{navprefix}}/customize-email-apis[Customize email template]
+* link:{{navprefix}}/in-app-navigation[Create dynamic menus and navigation]
+* link:{{navprefix}}/best-practices[Performance optimization]
+** link:{{navprefix}}/best-practices[Best practices]
+** link:{{navprefix}}/prerender[Prerender components]
+** link:{{navprefix}}/lazy-load-fullHeight[Full height and lazy loading options]
+** link:{{navprefix}}/prefetch[Prefetch static resources]
+* link:{{navprefix}}/troubleshoot-errors[Troubleshoot errors]
+
+[.sidebar-title]
+Authentication and data security
+
+* link:{{navprefix}}/embed-auth[Authentication]
+** link:{{navprefix}}/trusted-auth[Trusted authentication]
+*** link:{{navprefix}}/trusted-auth-secret-key[Secret key management]
+*** link:{{navprefix}}/trusted-auth-sdk[Front-end trusted authentication integration]
+*** link:{{navprefix}}/trusted-auth-token-request-service[Token request service]
+*** link:{{navprefix}}/trusted-auth-troubleshoot[Troubleshoot trusted authentication]
+** link:{{navprefix}}/saml-sso[SAML SSO authentication]
+** link:{{navprefix}}/oidc-auth[OpenID Connect authentication]
+** link:{{navprefix}}/just-in-time-provisioning[Just-in-time provisioning]
+* link:{{navprefix}}/security-settings[Security settings]
+
+* link:{{navprefix}}/embed-object-access[Authorization]
+** link:{{navprefix}}/access-control-sharing[Access control and sharing]
+** link:{{navprefix}}/privileges-and-roles[Privileges and Roles]
+** link:{{navprefix}}/data-security[Data security]
+*** link:{{navprefix}}/rls-rules[RLS Rules]
+*** link:{{navprefix}}/abac-via-rls-variables[ABAC via RLS with variables]
+*** link:{{navprefix}}/jwt-abac-migration-guide[ABAC JWT migration guide]
+**** link:{{navprefix}}/jwt-filter-parameters-rules-migration-guide[JWT ABAC with filter rules -> ABAC via RLS]
+**** link:{{navprefix}}/jwt-abac-beta-migration-guide[JWT ABAC beta implementation -> ABAC via RLS]
+*** link:{{navprefix}}/abac-user-parameters[ABAC via JWT with filter rules and parameters]
+* link:{{navprefix}}/selective-user-access[User access]
+* link:{{navprefix}}/troubleshoot-errors[Troubleshoot errors]
+
+[.sidebar-title]
+Authentication and data security
+
+* link:{{navprefix}}/tutorials/tutorials-overview[Embedding tutorials]
+* link:{{navprefix}}/tutorials/tse-fundamentals/intro[Embedding Fundamentals]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-01[01 - Overview]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-02[02 - Set up for course]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-03[03 - Security setup]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-04[04 - Start coding]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-05[05 - Embed Search]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-06[06 - Embed Natural Language Search]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-07[07 - Embed Liveboard]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-08[08 - Embed Visualization]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-09[09 - Embed full application]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-10[10 - Style embedded app]
+** link:{{navprefix}}/tutorials/tse-fundamentals/lesson-11[11 - Course summary]
+** link:{{navprefix}}/tutorials/style-customization/tutorial[Style customization]
+* link:{{navprefix}}/tutorials/react-components/intro[React components]
+** link:{{navprefix}}/tutorials/react-components/lesson-01[01 - Initialize Visual Embed SDK]
+** link:{{navprefix}}/tutorials/react-components/lesson-02[02 - ThoughtSpot component pages]
+** link:{{navprefix}}/tutorials/react-components/lesson-03[03 - Menus and navigation elements]
+** link:{{navprefix}}/tutorials/react-components/lesson-04[04 - Event handling]
+
+
+[.sidebar-title]
+Reference guides and changelog
+
+* +++<a href="{{previewPrefix}}/playground/search" target="_blank">Visual Embed Playground</a>+++
+* link:{{navprefix}}/VisualEmbedSdk[Visual Embed SDK Reference]
+include::generated/typedoc/CustomSideNav.adoc[]
+** Custom styles
+*** [.typedoc-Interface]#link:{{navprefix}}/Interface_CustomStyles[CustomStyles]#
+*** [.typedoc-Interface]#link:{{navprefix}}/Interface_CustomisationsInterface[CustomisationsInterface]#
+*** [.typedoc-Interface]#link:{{navprefix}}/Interface_customCssInterface[customCssInterface]#
+*** [.typedoc-Interface]#link:{{navprefix}}/Interface_CustomCssVariables[customCssVariables]#
+** Runtime filters
+*** [.typedoc-Interface]#link:{{navprefix}}/Interface_RuntimeFilter[RuntimeFilter]#
+*** [.typedoc-Enumeration]#link:{{navprefix}}/Enumeration_RuntimeFilterOp[RuntimeFilterOp]#
+** Others
+*** [.typedoc-Enumeration]#link:{{navprefix}}/Enumeration_Action[Action]#
+*** [.typedoc-Enumeration]#link:{{navprefix}}/Enumeration_ContextMenuTriggerOptions[ContextMenuTriggerOptions]#
+*** [.typedoc-Enumeration]#link:{{navprefix}}/Enumeration_DataSourceVisualMode[DataSourceVisualMode]#
+*** [.typedoc-Enumeration]#link:{{navprefix}}/Enumeration_Page[Page]#
+*** [.typedoc-Enumeration]#link:{{navprefix}}/Enumeration_PrefetchFeatures[PrefetchFeatures]#
+*** [.typedoc-Function]#link:{{navprefix}}/Function_executeTML[executeTML]#
+*** [.typedoc-Function]#link:{{navprefix}}/Function_exportTML[exportTML]#
+* link:{{navprefix}}/embed-sdk-changelog[Changelog]
+** link:{{navprefix}}/embed-sdk-changelog[Visual Embed SDK]
+** link:{{navprefix}}/mobile-sdk-changelog[Mobile Embed SDK]
+
+[.sidebar-title]
+Additional resources
+
+* link:{{navprefix}}/embed-ts[About ThoughtSpot embedding]
+* link:{{navprefix}}/get-started-tse[Embed licenses]
+* link:{{navprefix}}/license-feature-matrix[Feature matrix]
+* link:{{navprefix}}/faqs[FAQs]
+* link:{{navprefix}}/code-samples[Code samples]
+* link:https://codesandbox.io/s/big-tse-react-demo-i4g9xi[React CodeSandbox, window=_blank]
+* link:https://codesandbox.io/s/graphqlcookieembed-wf4fk9?file=/src/App.js:418-426[GraphQL CodeSandbox, window=_blank]
+

modules/ROOT/pages/common/nav-mcp-server.adoc

@@ -0,0 +1,32 @@
+
+:page-pageid: nav-mcp-server
+:page-description: MCP Server navigation
+
+[navSection]
+
+[.sidebar-title]
+ThoughtSpot MCP server
+
+* link:{{navprefix}}/mcp-integration[Overview]
+** link:{{navprefix}}/mcp-server-spotter3[MCP Server with Spotter 3]
+** link:{{navprefix}}/mcp-server-legacy[Legacy MCP Server architecture and tools]
+* link:{{navprefix}}/connect-mcp-server-to-clients[Connecting MCP Server to MCP clients]
+* link:{{navprefix}}/custom-chatbot-integration-mcp[Integrating MCP Server in a custom app]
+
+[.sidebar-title]
+MCP tools reference
+
+* link:{{navprefix}}/mcp-tool-reference[Overview]
+* link:{{navprefix}}/mcp-tool-reference-spotter3[MCP tool reference (Spotter 3)]
+* link:{{navprefix}}/mcp-tool-reference-spotter3[MCP tool reference (legacy version)]
+
+[.sidebar-title]
+Related SDK components
+
+* [.typedoc-Function]#link:{{navprefix}}/Function_startAutoMCPFrameRenderer[startAutoMCPFrameRenderer]#
+* [.typedoc-Interface]#link:{{navprefix}}/Interface_AutoMCPFrameRendererViewConfig[AutoMCPFrameRendererViewConfig]#
+
+[.sidebar-title]
+MCP Server release notes
+
+* link:{{navprefix}}/mcp-server-changelog[MCP Server changelog]