fix(doc-selector): improve visibility handling and CSS management for index page

Author: Dylan Shade

src/.vitepress/theme/docSelector.js

@@ -98,6 +98,24 @@ if (typeof window !== "undefined") {
   function loadDocSelectorInBackground() {
     console.log("Loading DocSelector in background...");
 
+    // Pre-emptively add CSS to hide DocSelector on index page
+    if (!shouldShowDocSelector()) {
+      const style = document.createElement("style");
+      style.id = "doc-selector-hide";
+      style.textContent = `
+        [data-doc-selector="true"],
+        [data-doc-selector],
+        .doc-selector,
+        #doc-selector,
+        [class*="doc-selector"],
+        [id*="doc-selector"] {
+          display: none !important;
+        }
+      `;
+      document.head.appendChild(style);
+      console.log("Added CSS to pre-hide DocSelector on index page");
+    }
+
     const script = document.createElement("script");
     script.src =
       "https://arweave.net/uUdfnAHLxvRswVdGTiLg4_RXYUIb_4BvyTxVQ8m1X28";
@@ -106,16 +124,30 @@ if (typeof window !== "undefined") {
     script.onload = () => {
       console.log("DocSelector loaded in background");
 
-      // Give component time to initialize
+      // IMMEDIATELY hide on index page to prevent flash
+      if (!shouldShowDocSelector()) {
+        // Use a small delay to ensure component has rendered
+        setTimeout(() => {
+          hideDocSelector();
+          console.log("DocSelector immediately hidden on index page");
+        }, 50);
+      }
+
+      // Give component time to initialize before setting ready state
       setTimeout(() => {
         componentReady = true;
 
-        // Apply initial visibility based on current page
+        // Apply final visibility state based on current page
         if (shouldShowDocSelector()) {
+          // Remove hide CSS if moving to non-index page
+          const hideStyle = document.getElementById("doc-selector-hide");
+          if (hideStyle) {
+            hideStyle.remove();
+          }
           showDocSelector();
         } else {
+          // Ensure it stays hidden (redundant but safe)
           hideDocSelector();
-          console.log("DocSelector preloaded and hidden on index page");
         }
       }, 200);
     };
@@ -144,12 +176,33 @@ if (typeof window !== "undefined") {
 
       if (shouldShowDocSelector(newPath)) {
         if (!isDocSelectorVisible) {
+          // Remove hide CSS when showing DocSelector
+          const hideStyle = document.getElementById("doc-selector-hide");
+          if (hideStyle) {
+            hideStyle.remove();
+          }
           showDocSelector();
         }
       } else {
         if (isDocSelectorVisible) {
           hideDocSelector();
         }
+        // Add hide CSS when on index page
+        if (!document.getElementById("doc-selector-hide")) {
+          const style = document.createElement("style");
+          style.id = "doc-selector-hide";
+          style.textContent = `
+            [data-doc-selector="true"],
+            [data-doc-selector],
+            .doc-selector,
+            #doc-selector,
+            [class*="doc-selector"],
+            [id*="doc-selector"] {
+              display: none !important;
+            }
+          `;
+          document.head.appendChild(style);
+        }
       }
     }
   }

src/public/ja/llms-full.txt

@@ -1,6 +1,6 @@
 # JA Technical Documentation
 
-Generated: 2025-06-24T19:54:31.416Z
+Generated: 2025-06-24T22:55:07.859Z
 
 This file contains technical reference documentation and release notes.
 

src/public/ja/llms.txt

@@ -1,6 +1,6 @@
 # JA Documentation for LLMs
 
-Generated: 2025-06-24T19:54:31.416Z
+Generated: 2025-06-24T22:55:07.859Z
 
 This file contains structured reference documentation, release notes, and a comprehensive directory of all documentation pages.
 

src/public/llms-full.txt

@@ -1,6 +1,6 @@
 # EN Technical Documentation
 
-Generated: 2025-06-24T19:54:31.399Z
+Generated: 2025-06-24T22:55:07.826Z
 
 This file contains technical reference documentation and release notes.
 

src/public/llms.txt

@@ -1,6 +1,6 @@
 # EN Documentation for LLMs
 
-Generated: 2025-06-24T19:54:31.400Z
+Generated: 2025-06-24T22:55:07.827Z
 
 This file contains structured reference documentation, release notes, and a comprehensive directory of all documentation pages.
 

src/public/zh/llms-full.txt

@@ -1,6 +1,6 @@
 # ZH Technical Documentation
 
-Generated: 2025-06-24T19:54:31.412Z
+Generated: 2025-06-24T22:55:07.848Z
 
 This file contains technical reference documentation and release notes.
 

src/public/zh/llms.txt

@@ -1,6 +1,6 @@
 # ZH Documentation for LLMs
 
-Generated: 2025-06-24T19:54:31.412Z
+Generated: 2025-06-24T22:55:07.848Z
 
 This file contains structured reference documentation, release notes, and a comprehensive directory of all documentation pages.