From 11427c11fc5d258ee13847f6bfc5e85b415faf0c Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Fri, 9 May 2025 14:50:33 +0200
Subject: [PATCH 01/16] fix: search button for field

---
 .../assets/styles/ast-search.scss             | 55 ++++++++++++++++---
 .../components/search-button-field.html       |  2 +-
 2 files changed, 47 insertions(+), 10 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index 6766c41e3..6d4d73c24 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -1,4 +1,8 @@
 /* Static Search Results Container */
+
+.bd-search{
+  display: flex;
+}
 .static-search-results {
   display: flex;
   flex-direction: column;
@@ -150,20 +154,53 @@ html[data-theme="light"] .highlight {
 }
 
 /* Responsive Styles */
-@media (max-width: 48rem) { /* 768px */
-  .bd-search input.expanded {
-    width: 6.25rem; /* 100px */
+@media (min-width: 64rem) and (max-width: 85.375rem) {
+  .bd-search {
+    flex-grow: 1;
+    justify-content: flex-end;
+    padding-left: 1rem;
+    padding-right: 1rem;
+  }
+
+  .bd-search input.form-control.expanded {
+    width: 16rem; /* 256px */
+  }
+
+  .bd-search input.form-control {
+    width: 8rem; /* 128px */
+  }
+
+  .bd-search .search-button__kbd-shortcut {
+    display: none !important;
+  }
+
+  /* Adjust top bar container if needed */
+  .navbar,
+  .topbar {
+    padding-left: 1rem;
+    padding-right: 1rem;
+    gap: 1rem;
+  }
+}
+
+@media (max-width: 64rem) {
+  .bd-search {
+    flex-grow: 1;
+    justify-content: flex-end;
+    padding-left: 1rem;
+    padding-right: 1rem;
   }
 
-  .form-control {
-    width: 3.125rem; /* 50px */
+  .bd-search input.form-control.expanded {
+    width: 10rem; /* 160px */
   }
 
-  .result {
-    width: 6.25rem; /* 100px */
+  .bd-search input.form-control {
+    width: 8rem; /* 128px */
   }
 
   .bd-search .search-button__kbd-shortcut {
-    display: none;
+    display: none !important;
   }
-}
\ No newline at end of file
+}
+/* Search Icon */
\ No newline at end of file
diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/components/search-button-field.html b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/components/search-button-field.html
index eee4e6945..6b197906f 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/components/search-button-field.html
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/components/search-button-field.html
@@ -1,5 +1,5 @@
 
-<div class="search-bar pst-js-only" id="search-bar">
+<div class="search-bar" id="search-bar">
   <form class="bd-search d-flex align-items-center" action="{{ pathto('search') }}" method="get">
     <i class="fa-solid fa-magnifying-glass"></i>
     <input type="search" class="form-control" name="q" placeholder="{{ theme_search_bar_text }}"

From 18db9c8260b734aa6380a5cfa10cfb47813f0a0b Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Fri, 9 May 2025 18:26:10 +0200
Subject: [PATCH 02/16] feat: search for mobile view

---
 .../assets/styles/ast-search.scss             | 23 +++++++++----
 .../ansys_sphinx_theme/static/js/search.js    | 32 ++++++++++++++++---
 2 files changed, 43 insertions(+), 12 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index 6d4d73c24..c2a719e3c 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -174,12 +174,8 @@ html[data-theme="light"] .highlight {
     display: none !important;
   }
 
-  /* Adjust top bar container if needed */
-  .navbar,
-  .topbar {
-    padding-left: 1rem;
-    padding-right: 1rem;
-    gap: 1rem;
+  .static-search-results {
+    width: 16rem; /* 256px */
   }
 }
 
@@ -199,8 +195,21 @@ html[data-theme="light"] .highlight {
     width: 8rem; /* 128px */
   }
 
+  .static-search-results {
+    width: 14rem; /* 160px */
+  }
+
   .bd-search .search-button__kbd-shortcut {
     display: none !important;
   }
 }
-/* Search Icon */
\ No newline at end of file
+/* Search Icon */
+
+@media (max-width: 600px) {
+  .bd-search input.form-control {
+    width: 100%;
+  }
+  #static-search-results {
+    max-width: 100%;
+  }
+}
\ No newline at end of file
diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index 059f253bd..3d73f97e4 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -1,6 +1,30 @@
-const SEARCH_BAR = document.getElementById("search-bar");
-const SEARCH_INPUT = SEARCH_BAR.querySelector(".bd-search input.form-control");
-const RESULTS = document.getElementById("static-search-results");
+// Determine which search bar to use (mobile or desktop)
+let SEARCH_BAR;
+
+if (window.innerWidth < 960) {
+  SEARCH_BAR = document.querySelector(".navbar-persistent--mobile #search-bar");
+} else {
+  SEARCH_BAR = document.getElementById("search-bar");
+}
+
+// Fallback if nothing is found
+if (!SEARCH_BAR) {
+  console.warn("SEARCH_BAR not found for current view.");
+}
+
+// Get input and results area
+
+const SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
+
+let RESULTS;
+if (window.innerWidth < 960) {
+  RESULTS = document.querySelector(
+    ".navbar-persistent--mobile .static-search-results",
+  );
+} else {
+  RESULTS = document.querySelector(".static-search-results");
+}
+
 const MAIN_PAGE_CONTENT = document.querySelector(".bd-main");
 let CURRENT_INDEX = -1;
 
@@ -144,7 +168,6 @@ require(["fuse"], function (Fuse) {
     searchingBanner.className = "searching-banner";
     searchingBanner.textContent = "Searching...";
     searchingBanner.style.display = "block";
-    console.log("Searching...");
     searchingBanner.style.fontStyle = "italic";
     RESULTS.appendChild(searchingBanner);
   }
@@ -248,7 +271,6 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // Add event listeners
   SEARCH_INPUT.addEventListener("click", expandSearchInput);
   SEARCH_INPUT.addEventListener("keydown", handleKeyDownSearchInput);
   document.addEventListener("keydown", handleGlobalKeyDown);

From 16da9ed328ebe5761188e84e7d10552339e77f27 Mon Sep 17 00:00:00 2001
From: pyansys-ci-bot <92810346+pyansys-ci-bot@users.noreply.github.com>
Date: Fri, 9 May 2025 16:28:49 +0000
Subject: [PATCH 03/16] chore: adding changelog file 689.fixed.md
 [dependabot-skip]

---
 doc/changelog.d/689.fixed.md | 1 +
 1 file changed, 1 insertion(+)
 create mode 100644 doc/changelog.d/689.fixed.md

diff --git a/doc/changelog.d/689.fixed.md b/doc/changelog.d/689.fixed.md
new file mode 100644
index 000000000..3cf7f559c
--- /dev/null
+++ b/doc/changelog.d/689.fixed.md
@@ -0,0 +1 @@
+smaller screen view and search for mobile views
\ No newline at end of file

From 18fe4aea7ffafa751c7ce9bc4c0951fa1d82cce9 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Mon, 12 May 2025 09:37:39 +0200
Subject: [PATCH 04/16] fix: add percentage

---
 .../assets/styles/ast-search.scss             | 41 +++++++------------
 1 file changed, 14 insertions(+), 27 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index c2a719e3c..21147c47d 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -155,19 +155,12 @@ html[data-theme="light"] .highlight {
 
 /* Responsive Styles */
 @media (min-width: 64rem) and (max-width: 85.375rem) {
-  .bd-search {
-    flex-grow: 1;
-    justify-content: flex-end;
-    padding-left: 1rem;
-    padding-right: 1rem;
-  }
-
   .bd-search input.form-control.expanded {
-    width: 16rem; /* 256px */
+    width: 100%; /* 320px */
   }
 
   .bd-search input.form-control {
-    width: 8rem; /* 128px */
+    width: 100%; /* 240px */
   }
 
   .bd-search .search-button__kbd-shortcut {
@@ -175,28 +168,22 @@ html[data-theme="light"] .highlight {
   }
 
   .static-search-results {
-    width: 16rem; /* 256px */
+    width: 30%; /* 480px */
   }
 }
 
 @media (max-width: 64rem) {
-  .bd-search {
-    flex-grow: 1;
-    justify-content: flex-end;
-    padding-left: 1rem;
-    padding-right: 1rem;
-  }
 
   .bd-search input.form-control.expanded {
-    width: 10rem; /* 160px */
+    width: 100%; /* 320px */
   }
 
   .bd-search input.form-control {
-    width: 8rem; /* 128px */
+    width: 100%; /* 240px */
   }
 
   .static-search-results {
-    width: 14rem; /* 160px */
+    width: 30%; /* 480px */
   }
 
   .bd-search .search-button__kbd-shortcut {
@@ -205,11 +192,11 @@ html[data-theme="light"] .highlight {
 }
 /* Search Icon */
 
-@media (max-width: 600px) {
-  .bd-search input.form-control {
-    width: 100%;
-  }
-  #static-search-results {
-    max-width: 100%;
-  }
-}
\ No newline at end of file
+// @media (max-width: 600px) {
+//   .bd-search input.form-control {
+//     width: 100%;
+//   }
+//   #static-search-results {
+//     max-width: 100%;
+//   }
+// }
\ No newline at end of file

From ae8fd4dd63bda19d2010811cab72334e7ad5fda4 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Mon, 12 May 2025 10:21:15 +0200
Subject: [PATCH 05/16] fix(styles): update the laptop width

---
 .../assets/styles/ast-search.scss             | 27 ++++++++++++-------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index 21147c47d..a9656f070 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -190,13 +190,22 @@ html[data-theme="light"] .highlight {
     display: none !important;
   }
 }
-/* Search Icon */
 
-// @media (max-width: 600px) {
-//   .bd-search input.form-control {
-//     width: 100%;
-//   }
-//   #static-search-results {
-//     max-width: 100%;
-//   }
-// }
\ No newline at end of file
+// laptop
+@media (min-width: 85.375rem)  and (max-width: 128rem) {
+  .bd-search input.form-control.expanded {
+    width: 35rem; /* 560px */
+  }
+
+  .bd-search input.form-control {
+    width: 100%; /* 240px */
+  }
+
+  .static-search-results {
+    width: 37rem; /* 600px */
+  }
+
+  .bd-search .search-button__kbd-shortcut {
+    display: none !important;
+  }
+}
\ No newline at end of file

From eebe5ae58cbec3b0e10bd5b221f63394065dcab7 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Mon, 12 May 2025 10:27:45 +0200
Subject: [PATCH 06/16] fix(styles): update the shortcut visisbility

---
 src/ansys_sphinx_theme/assets/styles/ast-search.scss | 8 --------
 1 file changed, 8 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index a9656f070..6c3b9736a 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -85,10 +85,6 @@ html[data-theme="light"] .highlight {
 .bd-search .search-button__kbd-shortcut {
   background-color: var(--ast-search-bar-enable-background) !important;
   box-shadow: none !important;
-  height: 2.25rem; /* 36px */
-  display: flex;
-  flex-wrap: wrap;
-  align-content: center;
 }
 
 /* Index Select Dropdown */
@@ -204,8 +200,4 @@ html[data-theme="light"] .highlight {
   .static-search-results {
     width: 37rem; /* 600px */
   }
-
-  .bd-search .search-button__kbd-shortcut {
-    display: none !important;
-  }
 }
\ No newline at end of file

From 8169bf7300ff3a333dc6a0d955d415a93733f03a Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Mon, 12 May 2025 15:12:14 +0200
Subject: [PATCH 07/16] fix(js): update the mobile search

---
 src/ansys_sphinx_theme/assets/styles/ast-search.scss     | 4 ++--
 .../theme/ansys_sphinx_theme/static/js/search.js         | 9 +++++----
 2 files changed, 7 insertions(+), 6 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index 6c3b9736a..f1e7cb917 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -164,7 +164,7 @@ html[data-theme="light"] .highlight {
   }
 
   .static-search-results {
-    width: 30%; /* 480px */
+    width: 50%; /* 480px */
   }
 }
 
@@ -179,7 +179,7 @@ html[data-theme="light"] .highlight {
   }
 
   .static-search-results {
-    width: 30%; /* 480px */
+    width: 50%; /* 480px */
   }
 
   .bd-search .search-button__kbd-shortcut {
diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index 3d73f97e4..1e4b5111f 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -1,8 +1,10 @@
 // Determine which search bar to use (mobile or desktop)
 let SEARCH_BAR;
-
+let RESULTS;
 if (window.innerWidth < 960) {
-  SEARCH_BAR = document.querySelector(".navbar-persistent--mobile #search-bar");
+  SEARCH_BAR = document.querySelector(
+    "div.sidebar-header-items__end #search-bar",
+  );
 } else {
   SEARCH_BAR = document.getElementById("search-bar");
 }
@@ -16,10 +18,9 @@ if (!SEARCH_BAR) {
 
 const SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
 
-let RESULTS;
 if (window.innerWidth < 960) {
   RESULTS = document.querySelector(
-    ".navbar-persistent--mobile .static-search-results",
+    ".sidebar-header-items__end .static-search-results",
   );
 } else {
   RESULTS = document.querySelector(".static-search-results");

From dfe3cbb12d0769737b56f3358760d8e7100d34d1 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Tue, 13 May 2025 10:02:38 +0200
Subject: [PATCH 08/16] fix: media container to 1040

---
 .../styles/ansys-sphinx-theme-variable.scss   | 131 ++++++++++++++++++
 1 file changed, 131 insertions(+)

diff --git a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
index b561bef7b..6ebc07925 100644
--- a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
@@ -16,6 +16,14 @@
 :root {
   /** Ansys specific changes to the theme */
 
+
+  --bs-breakpoint-lg: 1040px !important;
+  --bs-breakpoint-md: 720px;
+  --bs-breakpoint-sm: 540px;
+  --bs-breakpoint-xs: 0px;
+  --bs-breakpoint-xl: 1200px;
+   --breakpoint-sidebar-primary: 1040px;
+
   /**
   * Ansys Font family
   *
@@ -52,6 +60,7 @@
   --bs-nav-link-font-size: 0.875rem; /* 14px */
   --bs-navbar-color: var(--bs-ast-navbar-color);
   --ast-font-sidebar-header: 1rem; /* 16px */
+
   /**
 * weight
 */
@@ -422,3 +431,125 @@ h6 {
 h1 {
   line-height: 56px;
 }
+
+
+
+.navbar-header-items{
+  @media(min-width: 1040px) {
+    display: inherit;
+    flex-grow: 1;
+    padding: 0 0 0 0.5rem;
+  }
+}
+
+ul.navbar-nav {
+  @media(min-width: 1040px) {
+    align-items: baseline;
+    }
+  }
+button.primary-toggle {
+    margin-right: 1rem;
+
+    @media(min-width: 1040px) {
+      display: none;
+    }
+  }
+
+  @media(min-width: 1040px) {
+    .navbar-center-items .navbar-item {
+      display: inline-block;
+    }
+  }
+
+  .navbar-persistent--mobile {
+    margin-left: auto;
+
+    @media(min-width: 1040px) {
+      display: none;
+    }
+  }
+
+  // The navbar-persistent content should only show on wide screens
+  .navbar-persistent--container {
+    display: none;
+
+    @media(min-width: 1040px) {
+      display: flex;
+    }
+  }
+
+@media (min-width: 1040px) {
+    .bd-sidebar-primary {
+      position: fixed;
+      top: 0;
+      left: -100%;
+      height: 100%;
+      width: 250px; /* or your desired width */
+      transition: left 0.3s ease;
+      visibility: hidden;
+      background-color: #fff; /* optional */
+      z-index: 1030; /* adjust as needed */
+    }
+
+    .bd-sidebar-primary[open] {
+      left: 0;
+      visibility: visible;
+    }
+  }
+
+  @media (max-width: 1040px) {
+    .navbar-header-items {
+      display: none !important;;
+      flex-grow: 1 !important;;
+      padding: 0 0 0 0.5rem !important;;
+    }
+
+    ul.navbar-nav {
+      align-items: baseline;
+    }
+
+    .navbar-center-items .navbar-item {
+      display: inline-block;
+    }
+
+    .navbar-persistent--mobile {
+      display: none;
+    }
+
+    .navbar-persistent--container {
+      display: flex;
+    }
+
+    .bd-sidebar-primary {
+      position: fixed;
+      top: 0;
+      left: -100%;
+      height: 100%;
+      width: 250px; /* Customize as needed */
+      transition: left 0.3s ease;
+      visibility: hidden;
+      background-color: #fff;
+      z-index: 1030; /* Ensure it's above other elements */
+    }
+
+    .bd-sidebar-primary[open] {
+      left: 0;
+      visibility: visible !important;
+    }
+
+    button.primary-toggle {
+      display: flex !important;
+    }
+  }
+
+  button.primary-toggle {
+    margin-right: 1rem;
+  }
+
+  .navbar-persistent--mobile {
+    margin-left: auto;
+  }
+
+  .navbar-persistent--container {
+    display: none;
+  }
\ No newline at end of file

From 2eacb3ef9d4f6f89c75e3c541f8bcf9c6f326d6e Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Tue, 13 May 2025 10:16:08 +0200
Subject: [PATCH 09/16] fix: media sidebar

---
 .../styles/ansys-sphinx-theme-variable.scss       | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
index 6ebc07925..778b75309 100644
--- a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
@@ -540,6 +540,21 @@ button.primary-toggle {
     button.primary-toggle {
       display: flex !important;
     }
+    #pst-collapse-sidebar-button {
+      display: none !important;
+    }
+    nav.bd-links {
+      display: block !important;
+    }
+    .nav-link .hide-on-wide {
+      display: none !important;
+    }
+    .bd-sidebar-primary.hide-on-wide {
+      display: flex !important;
+    }
+    .bd-sidebar-primary .sidebar-header-items {
+      display: flex !important;
+    }
   }
 
   button.primary-toggle {

From af19fd63b593054a035bd4640a184d28016b1d58 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Tue, 13 May 2025 10:33:10 +0200
Subject: [PATCH 10/16] feat: add minimum to 1040px

---
 src/ansys_sphinx_theme/assets/styles/ast-search.scss   |  4 ++--
 .../assets/styles/pydata-sphinx-theme-custom.scss      |  8 ++++----
 .../theme/ansys_sphinx_theme/static/js/search.js       | 10 +++++++---
 3 files changed, 13 insertions(+), 9 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index f1e7cb917..a171b431a 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -150,7 +150,7 @@ html[data-theme="light"] .highlight {
 }
 
 /* Responsive Styles */
-@media (min-width: 64rem) and (max-width: 85.375rem) {
+@media (min-width: 1040px) and (max-width: 85.375rem) {
   .bd-search input.form-control.expanded {
     width: 100%; /* 320px */
   }
@@ -168,7 +168,7 @@ html[data-theme="light"] .highlight {
   }
 }
 
-@media (max-width: 64rem) {
+@media (max-width: 1040px) {
 
   .bd-search input.form-control.expanded {
     width: 100%; /* 320px */
diff --git a/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss b/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss
index 5863c81ca..fde40746a 100644
--- a/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss
+++ b/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss
@@ -744,25 +744,25 @@ button.btn.version-switcher__button:hover {
   max-width: 100%;
 }
 
-@media (min-width: 960px) {
+@media (min-width: 1040px) {
   .bd-sidebar-primary {
     width: 20%;
   }
 }
 
-@media (min-width: 960px) {
+@media (min-width: 1040px) {
   .col-lg-3 {
     width: fit-content;
   }
 }
 
-@media (min-width: 960px) {
+@media (min-width: 1040px) {
   .bd-page-width {
     max-width: min(100%, 1700px) !important;
   }
 }
 
-@media (min-width: 960px) {
+@media (min-width: 1040px) {
   .bd-main .bd-content .bd-article-container {
     width: min(100%, 1070px);
   }
diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index 1e4b5111f..eadc5efdc 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -1,7 +1,7 @@
 // Determine which search bar to use (mobile or desktop)
 let SEARCH_BAR;
 let RESULTS;
-if (window.innerWidth < 960) {
+if (window.innerWidth < 1040) {
   SEARCH_BAR = document.querySelector(
     "div.sidebar-header-items__end #search-bar",
   );
@@ -9,6 +9,7 @@ if (window.innerWidth < 960) {
   SEARCH_BAR = document.getElementById("search-bar");
 }
 
+console.log("SEARCH_BAR", SEARCH_BAR);
 // Fallback if nothing is found
 if (!SEARCH_BAR) {
   console.warn("SEARCH_BAR not found for current view.");
@@ -18,9 +19,9 @@ if (!SEARCH_BAR) {
 
 const SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
 
-if (window.innerWidth < 960) {
+if (window.innerWidth < 1040) {
   RESULTS = document.querySelector(
-    ".sidebar-header-items__end .static-search-results",
+    "div.sidebar-header-items__end .static-search-results",
   );
 } else {
   RESULTS = document.querySelector(".static-search-results");
@@ -267,6 +268,9 @@ require(["fuse"], function (Fuse) {
 
   // Handle click event globally
   function handleGlobalClick(event) {
+    console.log("event.target", event.target);
+    console.log("SEARCH_INPUT", SEARCH_INPUT);
+    console.log("RESULTS", RESULTS);
     if (!RESULTS.contains(event.target) && event.target !== SEARCH_INPUT) {
       collapseSearchInput();
     }

From d2c801b573ca916a509b22c5934ba43672dc8377 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Tue, 13 May 2025 10:48:56 +0200
Subject: [PATCH 11/16] fix: cleanup

---
 .../styles/ansys-sphinx-theme-variable.scss   | 182 +++++++-----------
 .../assets/styles/ast-search.scss             |   2 +-
 .../ansys_sphinx_theme/static/js/search.js    |   4 -
 3 files changed, 75 insertions(+), 113 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
index 778b75309..7c2eff31b 100644
--- a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
@@ -433,138 +433,104 @@ h1 {
 }
 
 
-
-.navbar-header-items{
-  @media(min-width: 1040px) {
-    display: inherit;
-    flex-grow: 1;
-    padding: 0 0 0 0.5rem;
+/* Mobile-specific overrides (≤ 1040px) */
+@media (max-width: 1040px) {
+  .navbar-header-items {
+    display: none !important;
+    flex-grow: 1 !important;
+    padding: 0 0 0 0.5rem !important;
   }
-}
 
-ul.navbar-nav {
-  @media(min-width: 1040px) {
+  ul.navbar-nav {
     align-items: baseline;
-    }
   }
-button.primary-toggle {
-    margin-right: 1rem;
 
-    @media(min-width: 1040px) {
-      display: none;
-    }
+  .navbar-center-items .navbar-item {
+    display: inline-block;
   }
 
-  @media(min-width: 1040px) {
-    .navbar-center-items .navbar-item {
-      display: inline-block;
-    }
+  .navbar-persistent--mobile {
+    display: none;
   }
 
-  .navbar-persistent--mobile {
-    margin-left: auto;
+  .navbar-persistent--container {
+    display: flex;
+  }
 
-    @media(min-width: 1040px) {
-      display: none;
-    }
+  .bd-sidebar-primary {
+    flex-grow: 0.75;
+    height: 100vh;
+    left: 0;
+    margin-left: -75%;
+    max-height: 100vh !important;
+    max-width: 350px !important;
+    position: fixed;
+    top: 0;
+    transition: visibility 0.2s ease-out,margin 0.2s ease-out;
+    visibility: hidden;
+    width: 75%;
+    z-index: 1050;
+    display: flex !important;
   }
 
-  // The navbar-persistent content should only show on wide screens
-  .navbar-persistent--container {
-    display: none;
+  .bd-sidebar-primary[open] {
+    visibility: visible !important;
+  }
 
-    @media(min-width: 1040px) {
-      display: flex;
-    }
+  button.primary-toggle {
+    display: flex !important;
   }
 
+  #pst-collapse-sidebar-button {
+    display: none !important;
+  }
+
+  nav.bd-links {
+    display: block !important;
+  }
+
+  .nav-link .hide-on-wide {
+    display: none !important;
+  }
+
+  .bd-sidebar-primary.hide-on-wide {
+    display: flex !important;
+  }
+
+  .bd-sidebar-primary .sidebar-header-items {
+    display: flex !important;
+  }
+}
+
+/* Desktop-specific overrides (> 1040px) */
 @media (min-width: 1040px) {
-    .bd-sidebar-primary {
-      position: fixed;
-      top: 0;
-      left: -100%;
-      height: 100%;
-      width: 250px; /* or your desired width */
-      transition: left 0.3s ease;
-      visibility: hidden;
-      background-color: #fff; /* optional */
-      z-index: 1030; /* adjust as needed */
-    }
-
-    .bd-sidebar-primary[open] {
-      left: 0;
-      visibility: visible;
-    }
+  .navbar-header-items {
+    display: inherit;
+    flex-grow: 1;
+    padding: 0 0 0 0.5rem;
   }
 
-  @media (max-width: 1040px) {
-    .navbar-header-items {
-      display: none !important;;
-      flex-grow: 1 !important;;
-      padding: 0 0 0 0.5rem !important;;
-    }
-
-    ul.navbar-nav {
-      align-items: baseline;
-    }
-
-    .navbar-center-items .navbar-item {
-      display: inline-block;
-    }
-
-    .navbar-persistent--mobile {
-      display: none;
-    }
-
-    .navbar-persistent--container {
-      display: flex;
-    }
-
-    .bd-sidebar-primary {
-      position: fixed;
-      top: 0;
-      left: -100%;
-      height: 100%;
-      width: 250px; /* Customize as needed */
-      transition: left 0.3s ease;
-      visibility: hidden;
-      background-color: #fff;
-      z-index: 1030; /* Ensure it's above other elements */
-    }
-
-    .bd-sidebar-primary[open] {
-      left: 0;
-      visibility: visible !important;
-    }
-
-    button.primary-toggle {
-      display: flex !important;
-    }
-    #pst-collapse-sidebar-button {
-      display: none !important;
-    }
-    nav.bd-links {
-      display: block !important;
-    }
-    .nav-link .hide-on-wide {
-      display: none !important;
-    }
-    .bd-sidebar-primary.hide-on-wide {
-      display: flex !important;
-    }
-    .bd-sidebar-primary .sidebar-header-items {
-      display: flex !important;
-    }
+  ul.navbar-nav {
+    align-items: baseline;
   }
 
-  button.primary-toggle {
-    margin-right: 1rem;
+  .navbar-center-items .navbar-item {
+    display: inline-block;
   }
 
   .navbar-persistent--mobile {
-    margin-left: auto;
+    display: none;
   }
 
   .navbar-persistent--container {
+    display: flex;
+  }
+
+  .bd-sidebar-primary {
+    font-size: var(--pst-sidebar-font-size);
+  }
+
+  button.primary-toggle {
     display: none;
-  }
\ No newline at end of file
+  }
+}
\ No newline at end of file
diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index a171b431a..028444124 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -171,7 +171,7 @@ html[data-theme="light"] .highlight {
 @media (max-width: 1040px) {
 
   .bd-search input.form-control.expanded {
-    width: 100%; /* 320px */
+    width: 5rem; /* 320px */
   }
 
   .bd-search input.form-control {
diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index eadc5efdc..99bc8f08d 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -9,7 +9,6 @@ if (window.innerWidth < 1040) {
   SEARCH_BAR = document.getElementById("search-bar");
 }
 
-console.log("SEARCH_BAR", SEARCH_BAR);
 // Fallback if nothing is found
 if (!SEARCH_BAR) {
   console.warn("SEARCH_BAR not found for current view.");
@@ -268,9 +267,6 @@ require(["fuse"], function (Fuse) {
 
   // Handle click event globally
   function handleGlobalClick(event) {
-    console.log("event.target", event.target);
-    console.log("SEARCH_INPUT", SEARCH_INPUT);
-    console.log("RESULTS", RESULTS);
     if (!RESULTS.contains(event.target) && event.target !== SEARCH_INPUT) {
       collapseSearchInput();
     }

From 45acf4a300468173f95a397d276f5406c82dbd65 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Tue, 13 May 2025 11:24:04 +0200
Subject: [PATCH 12/16] fix(styles): breakpoint to 1200

---
 .../styles/ansys-sphinx-theme-variable.scss     | 17 ++++-------------
 .../assets/styles/ast-search.scss               |  4 ++--
 .../styles/pydata-sphinx-theme-custom.scss      |  8 ++++----
 .../ansys_sphinx_theme/static/js/search.js      |  4 ++--
 4 files changed, 12 insertions(+), 21 deletions(-)

diff --git a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
index 7c2eff31b..2e215dcc9 100644
--- a/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ansys-sphinx-theme-variable.scss
@@ -15,15 +15,6 @@
 
 :root {
   /** Ansys specific changes to the theme */
-
-
-  --bs-breakpoint-lg: 1040px !important;
-  --bs-breakpoint-md: 720px;
-  --bs-breakpoint-sm: 540px;
-  --bs-breakpoint-xs: 0px;
-  --bs-breakpoint-xl: 1200px;
-   --breakpoint-sidebar-primary: 1040px;
-
   /**
   * Ansys Font family
   *
@@ -433,8 +424,8 @@ h1 {
 }
 
 
-/* Mobile-specific overrides (≤ 1040px) */
-@media (max-width: 1040px) {
+/* Mobile-specific overrides (≤ 1200px) */
+@media (max-width: 1200px) {
   .navbar-header-items {
     display: none !important;
     flex-grow: 1 !important;
@@ -502,8 +493,8 @@ h1 {
   }
 }
 
-/* Desktop-specific overrides (> 1040px) */
-@media (min-width: 1040px) {
+/* Desktop-specific overrides (> 1200px) */
+@media (min-width: 1200px) {
   .navbar-header-items {
     display: inherit;
     flex-grow: 1;
diff --git a/src/ansys_sphinx_theme/assets/styles/ast-search.scss b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
index 028444124..873eaacff 100644
--- a/src/ansys_sphinx_theme/assets/styles/ast-search.scss
+++ b/src/ansys_sphinx_theme/assets/styles/ast-search.scss
@@ -150,7 +150,7 @@ html[data-theme="light"] .highlight {
 }
 
 /* Responsive Styles */
-@media (min-width: 1040px) and (max-width: 85.375rem) {
+@media (min-width: 1200px) and (max-width: 85.375rem) {
   .bd-search input.form-control.expanded {
     width: 100%; /* 320px */
   }
@@ -168,7 +168,7 @@ html[data-theme="light"] .highlight {
   }
 }
 
-@media (max-width: 1040px) {
+@media (max-width: 1200px) {
 
   .bd-search input.form-control.expanded {
     width: 5rem; /* 320px */
diff --git a/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss b/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss
index fde40746a..8581dbf82 100644
--- a/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss
+++ b/src/ansys_sphinx_theme/assets/styles/pydata-sphinx-theme-custom.scss
@@ -744,25 +744,25 @@ button.btn.version-switcher__button:hover {
   max-width: 100%;
 }
 
-@media (min-width: 1040px) {
+@media (min-width: 1200px) {
   .bd-sidebar-primary {
     width: 20%;
   }
 }
 
-@media (min-width: 1040px) {
+@media (min-width: 1200px) {
   .col-lg-3 {
     width: fit-content;
   }
 }
 
-@media (min-width: 1040px) {
+@media (min-width: 1200px) {
   .bd-page-width {
     max-width: min(100%, 1700px) !important;
   }
 }
 
-@media (min-width: 1040px) {
+@media (min-width: 1200px) {
   .bd-main .bd-content .bd-article-container {
     width: min(100%, 1070px);
   }
diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index 99bc8f08d..d839bcc07 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -1,7 +1,7 @@
 // Determine which search bar to use (mobile or desktop)
 let SEARCH_BAR;
 let RESULTS;
-if (window.innerWidth < 1040) {
+if (window.innerWidth < 1200) {
   SEARCH_BAR = document.querySelector(
     "div.sidebar-header-items__end #search-bar",
   );
@@ -18,7 +18,7 @@ if (!SEARCH_BAR) {
 
 const SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
 
-if (window.innerWidth < 1040) {
+if (window.innerWidth < 1200) {
   RESULTS = document.querySelector(
     "div.sidebar-header-items__end .static-search-results",
   );

From 4231698d4f04345452987ecfc0b8fe7362079cde Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Tue, 13 May 2025 17:12:44 +0200
Subject: [PATCH 13/16] fix: media sidebar

---
 .../ansys_sphinx_theme/static/js/search.js    | 19 +++++++------------
 1 file changed, 7 insertions(+), 12 deletions(-)

diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index d839bcc07..41fafe33f 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -1,30 +1,25 @@
 // Determine which search bar to use (mobile or desktop)
 let SEARCH_BAR;
 let RESULTS;
+let SEARCH_INPUT;
+
 if (window.innerWidth < 1200) {
   SEARCH_BAR = document.querySelector(
     "div.sidebar-header-items__end #search-bar",
   );
+  RESULTS = document.querySelector(
+    "div.sidebar-header-items__end .static-search-results",
+  );
 } else {
   SEARCH_BAR = document.getElementById("search-bar");
+  RESULTS = document.querySelector(".static-search-results");
 }
 
-// Fallback if nothing is found
 if (!SEARCH_BAR) {
   console.warn("SEARCH_BAR not found for current view.");
 }
 
-// Get input and results area
-
-const SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
-
-if (window.innerWidth < 1200) {
-  RESULTS = document.querySelector(
-    "div.sidebar-header-items__end .static-search-results",
-  );
-} else {
-  RESULTS = document.querySelector(".static-search-results");
-}
+SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
 
 const MAIN_PAGE_CONTENT = document.querySelector(".bd-main");
 let CURRENT_INDEX = -1;

From 3ce2acc3f39c01df6711b7d5057632b04612406c Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Fri, 16 May 2025 14:22:53 +0200
Subject: [PATCH 14/16] feat: add resize window

---
 .../ansys_sphinx_theme/static/js/search.js    | 49 ++++++++++++-------
 1 file changed, 31 insertions(+), 18 deletions(-)

diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index 41fafe33f..c009c98d7 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -3,24 +3,6 @@ let SEARCH_BAR;
 let RESULTS;
 let SEARCH_INPUT;
 
-if (window.innerWidth < 1200) {
-  SEARCH_BAR = document.querySelector(
-    "div.sidebar-header-items__end #search-bar",
-  );
-  RESULTS = document.querySelector(
-    "div.sidebar-header-items__end .static-search-results",
-  );
-} else {
-  SEARCH_BAR = document.getElementById("search-bar");
-  RESULTS = document.querySelector(".static-search-results");
-}
-
-if (!SEARCH_BAR) {
-  console.warn("SEARCH_BAR not found for current view.");
-}
-
-SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
-
 const MAIN_PAGE_CONTENT = document.querySelector(".bd-main");
 let CURRENT_INDEX = -1;
 
@@ -267,6 +249,37 @@ require(["fuse"], function (Fuse) {
     }
   }
 
+  function setupSearchElements() {
+    if (window.innerWidth < 1200) {
+      SEARCH_BAR = document.querySelector(
+        "div.sidebar-header-items__end #search-bar",
+      );
+      RESULTS = document.querySelector(
+        "div.sidebar-header-items__end .static-search-results",
+      );
+    } else {
+      SEARCH_BAR = document.getElementById("search-bar");
+      RESULTS = document.querySelector(".static-search-results");
+    }
+
+    if (!SEARCH_BAR) {
+      console.warn("SEARCH_BAR not found for current view.");
+    }
+
+    SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
+
+    if (SEARCH_INPUT) {
+      SEARCH_INPUT.addEventListener("click", expandSearchInput);
+      SEARCH_INPUT.addEventListener("keydown", handleKeyDownSearchInput);
+    }
+  }
+
+  // Initial setup
+  setupSearchElements();
+
+  // Re-run on resize
+  window.addEventListener("resize", debounce(setupSearchElements, 250));
+
   SEARCH_INPUT.addEventListener("click", expandSearchInput);
   SEARCH_INPUT.addEventListener("keydown", handleKeyDownSearchInput);
   document.addEventListener("keydown", handleGlobalKeyDown);

From d9c84efd1292e4a9ebfe89702403c76fc70b55ed Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Fri, 16 May 2025 14:41:06 +0200
Subject: [PATCH 15/16] feat: add container width

---
 .../ansys_sphinx_theme/static/js/search.js    | 272 +++++++++---------
 1 file changed, 133 insertions(+), 139 deletions(-)

diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index c009c98d7..6ee23ab8e 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -1,84 +1,113 @@
-// Determine which search bar to use (mobile or desktop)
-let SEARCH_BAR;
-let RESULTS;
-let SEARCH_INPUT;
+// ==============================
+// Fuse.js Search Integration
+// ==============================
 
+// Constants
 const MAIN_PAGE_CONTENT = document.querySelector(".bd-main");
-let CURRENT_INDEX = -1;
-
 const FUSE_VERSION = "6.4.6";
+let SEARCH_BAR,
+  RESULTS,
+  SEARCH_INPUT,
+  CURRENT_INDEX = -1;
+let fuse;
 
+// Configure Fuse.js path
 require.config({
   paths: {
     fuse: `https://cdn.jsdelivr.net/npm/fuse.js@${FUSE_VERSION}/dist/fuse.min`,
   },
 });
 
+// Load Fuse.js and set up the search system
 require(["fuse"], function (Fuse) {
-  // Declare global variables
-  let fuse;
+  // -------------------------------------
+  // Utility Functions
+  // -------------------------------------
 
-  // Debounce function to limit the rate of function calls
-  function debounce(func, delay) {
+  const debounce = (func, delay) => {
     let timeout;
-    return function (...args) {
+    return (...args) => {
       clearTimeout(timeout);
       timeout = setTimeout(() => func.apply(this, args), delay);
     };
-  }
+  };
 
-  // Initialize Fuse when the data is fetched
-  function initializeFuse(data, options) {
-    fuse = new Fuse(data, options);
-    // add env variable "FUSE_ACTIVE" to indicate that the search is ready
-    document.documentElement.setAttribute("data-fuse_active", "true");
-  }
+  const truncateTextPreview = (text, maxLength = 200) =>
+    text.length <= maxLength ? text : `${text.slice(0, maxLength)}...`;
+
+  const getDynamicPath = (targetFile) => {
+    const contentRoot =
+      document.documentElement.getAttribute("data-content_root");
+    return `${contentRoot}${targetFile}`;
+  };
+
+  const navigateToHref = (href) => {
+    window.location.href = getDynamicPath(href);
+  };
+
+  // -------------------------------------
+  // UI Handlers
+  // -------------------------------------
 
-  // Expand the search bar input
   function expandSearchInput() {
     RESULTS.style.display = "flex";
     SEARCH_INPUT.classList.add("expanded");
     MAIN_PAGE_CONTENT.classList.add("blurred");
     SEARCH_INPUT.focus();
+    // 🛠️ Fix overlap on mobile: reduce the opacity of the container
+    const modalSidebar = document.querySelector(
+      "#pst-primary-sidebar-modal > div.sidebar-primary-items__start.sidebar-primary__section",
+    );
+    if (modalSidebar) {
+      modalSidebar.style.opacity = "0.1";
+    }
   }
 
-  // Collapse the search bar input and hide any results
   function collapseSearchInput() {
     RESULTS.style.display = "none";
     SEARCH_INPUT.classList.remove("expanded");
     SEARCH_INPUT.value = "";
     MAIN_PAGE_CONTENT.classList.remove("blurred");
+    CURRENT_INDEX = -1;
+    const modalSidebar = document.querySelector(
+      "#pst-primary-sidebar-modal > div.sidebar-primary-items__start.sidebar-primary__section",
+    );
+    if (modalSidebar) {
+      modalSidebar.style.opacity = "1";
+    }
   }
 
-  // Truncate the preview of the text
-  function truncateTextPreview(text, maxLength = 200) {
-    if (text.length <= maxLength) {
-      return text; // If the text is already within the limit, return as is
-    }
-    return text.slice(0, maxLength) + "...";
+  function noResultsFoundBanner() {
+    RESULTS.innerHTML = "";
+    RESULTS.style.display = "flex";
+    const banner = document.createElement("div");
+    banner.className = "warning-banner";
+    banner.textContent = "No results found. Press Enter for extended search.";
+    banner.style.fontStyle = "italic";
+    RESULTS.appendChild(banner);
+  }
+
+  function searchingForResultsBanner() {
+    RESULTS.innerHTML = "";
+    RESULTS.style.display = "flex";
+    const banner = document.createElement("div");
+    banner.className = "searching-banner";
+    banner.textContent = "Searching...";
+    banner.style.fontStyle = "italic";
+    RESULTS.appendChild(banner);
   }
 
-  // Display search results
   function displayResults(results) {
-    if (!RESULTS) {
-      console.error("RESULTS element is not defined.");
-      return;
-    }
+    RESULTS.innerHTML = "";
 
     if (results.length === 0) {
       noResultsFoundBanner();
-      RESULTS.style.display = "none";
       return;
     }
 
-    RESULTS.style.display = "flex";
-    RESULTS.innerHTML = "";
-
     const fragment = document.createDocumentFragment();
 
-    results.forEach((result) => {
-      const { title, text, href } = result.item;
-
+    results.forEach(({ item: { title, text, href } }) => {
       const resultItem = document.createElement("div");
       resultItem.className = "result-item";
       resultItem.dataset.href = href;
@@ -87,21 +116,20 @@ require(["fuse"], function (Fuse) {
       const resultTitle = document.createElement("div");
       resultTitle.className = "result-title";
       resultTitle.textContent = title;
-      resultItem.appendChild(resultTitle);
 
       const resultText = document.createElement("div");
       resultText.className = "result-text";
-      const highlightedText = truncateTextPreview(text);
-      resultText.textContent = highlightedText;
-      resultItem.appendChild(resultText);
+      resultText.textContent = truncateTextPreview(text);
 
+      resultItem.appendChild(resultTitle);
+      resultItem.appendChild(resultText);
       fragment.appendChild(resultItem);
     });
 
     RESULTS.appendChild(fragment);
+    RESULTS.style.display = "flex";
   }
 
-  // Focus the selected result item
   function focusSelected(resultsItems) {
     if (CURRENT_INDEX >= 0 && CURRENT_INDEX < resultsItems.length) {
       resultsItems.forEach((item) => item.classList.remove("selected"));
@@ -112,65 +140,27 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // Display a banner indicating that the search is running
-  function noResultsFoundBanner() {
-    RESULTS.innerHTML = "";
-    RESULTS.style.display = "flex";
-    const warningBanner = document.createElement("div");
-    warningBanner.className = "warning-banner";
-    warningBanner.textContent =
-      "No results found. Press Enter for extended search.";
-    warningBanner.style.display = "block";
-    warningBanner.style.fontStyle = "italic";
-    RESULTS.appendChild(warningBanner);
-  }
-
-  // Build the complete hyperlink for the target file
-  function getDynamicPath(targetFile) {
-    const contentRoot =
-      document.documentElement.getAttribute("data-content_root");
-    return `${contentRoot}${targetFile}`;
-  }
-
-  // Navigate to the desired file
-  function navigateToHref(href) {
-    const finalUrl = getDynamicPath(href);
-    window.location.href = finalUrl;
-  }
+  // -------------------------------------
+  // Search Logic
+  // -------------------------------------
 
-  // Display a banner indicating that no results were found
-  function searchingForResultsBanner() {
-    RESULTS.innerHTML = "";
-    RESULTS.style.display = "flex";
-    const searchingBanner = document.createElement("div");
-    searchingBanner.className = "searching-banner";
-    searchingBanner.textContent = "Searching...";
-    searchingBanner.style.display = "block";
-    searchingBanner.style.fontStyle = "italic";
-    RESULTS.appendChild(searchingBanner);
-  }
-
-  // Handle search input
   const handleSearchInput = debounce(
     () => {
       const query = SEARCH_INPUT.value.trim();
-      if (query.length > 0) {
-        const searchResults = fuse.search(query, {
-          limit: parseInt(SEARCH_OPTIONS.limit),
-        });
-        if (searchResults.length === 0) {
-          noResultsFoundBanner();
-        } else {
-          displayResults(searchResults);
-        }
-      } else {
+      if (!query) {
         RESULTS.style.display = "none";
+        return;
       }
+
+      const searchResults = fuse.search(query, {
+        limit: parseInt(SEARCH_OPTIONS.limit),
+      });
+
+      displayResults(searchResults);
     },
     parseInt(SEARCH_OPTIONS.delay) || 300,
   );
 
-  // Handle keydown event for the search input
   function handleKeyDownSearchInput(event) {
     const resultItems = RESULTS.querySelectorAll(".result-item");
 
@@ -181,26 +171,25 @@ require(["fuse"], function (Fuse) {
 
       case "Escape":
         collapseSearchInput();
-        break; // Added break to avoid fall-through
+        break;
 
       case "Enter":
-        // Optionally handle Enter key here
-        if (CURRENT_INDEX >= 0 && CURRENT_INDEX < resultItems.length) {
-          event.preventDefault(); // Prevent default enter action
-          const href = resultItems[CURRENT_INDEX].dataset.href;
-          navigateToHref(href);
-        }
-        if (resultItems.length > 0) {
-          event.preventDefault(); // Prevent default enter action
-          const href = resultItems[0].dataset.href;
+        event.preventDefault();
+        const indexToNavigate =
+          CURRENT_INDEX >= 0 && CURRENT_INDEX < resultItems.length
+            ? CURRENT_INDEX
+            : resultItems.length > 0
+              ? 0
+              : -1;
+        if (indexToNavigate >= 0) {
+          const href = resultItems[indexToNavigate].dataset.href;
           navigateToHref(href);
         }
-
         break;
 
       case "ArrowDown":
         if (resultItems.length > 0) {
-          CURRENT_INDEX = (CURRENT_INDEX + 1) % resultItems.length; // Move down
+          CURRENT_INDEX = (CURRENT_INDEX + 1) % resultItems.length;
           focusSelected(resultItems);
         }
         break;
@@ -208,13 +197,12 @@ require(["fuse"], function (Fuse) {
       case "ArrowUp":
         if (resultItems.length > 0) {
           CURRENT_INDEX =
-            (CURRENT_INDEX - 1 + resultItems.length) % resultItems.length; // Move up
+            (CURRENT_INDEX - 1 + resultItems.length) % resultItems.length;
           focusSelected(resultItems);
         }
         break;
 
       default:
-        // if environment variable "FUSE_ACTIVE" is set to true
         if (
           document.documentElement.getAttribute("data-fuse_active") === "true"
         ) {
@@ -227,27 +215,9 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // Handle keydown event globally
-  function handleGlobalKeyDown(event) {
-    switch (event.key) {
-      case "k":
-        if (event.ctrlKey) {
-          expandSearchInput();
-        }
-        break;
-
-      case "Escape":
-        collapseSearchInput();
-        break;
-    }
-  }
-
-  // Handle click event globally
-  function handleGlobalClick(event) {
-    if (!RESULTS.contains(event.target) && event.target !== SEARCH_INPUT) {
-      collapseSearchInput();
-    }
-  }
+  // -------------------------------------
+  // Setup and Events
+  // -------------------------------------
 
   function setupSearchElements() {
     if (window.innerWidth < 1200) {
@@ -264,9 +234,10 @@ require(["fuse"], function (Fuse) {
 
     if (!SEARCH_BAR) {
       console.warn("SEARCH_BAR not found for current view.");
+      return;
     }
 
-    SEARCH_INPUT = SEARCH_BAR?.querySelector(".bd-search input.form-control");
+    SEARCH_INPUT = SEARCH_BAR.querySelector(".bd-search input.form-control");
 
     if (SEARCH_INPUT) {
       SEARCH_INPUT.addEventListener("click", expandSearchInput);
@@ -274,18 +245,34 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // Initial setup
-  setupSearchElements();
+  function handleGlobalKeyDown(event) {
+    if (event.key === "Escape") {
+      collapseSearchInput();
+    } else if (event.key === "k" && event.ctrlKey) {
+      expandSearchInput();
+    }
+  }
 
-  // Re-run on resize
-  window.addEventListener("resize", debounce(setupSearchElements, 250));
+  function handleGlobalClick(event) {
+    if (!RESULTS.contains(event.target) && event.target !== SEARCH_INPUT) {
+      collapseSearchInput();
+    }
+  }
+
+  // -------------------------------------
+  // Initialize
+  // -------------------------------------
 
-  SEARCH_INPUT.addEventListener("click", expandSearchInput);
-  SEARCH_INPUT.addEventListener("keydown", handleKeyDownSearchInput);
+  setupSearchElements();
+  window.addEventListener(
+    "resize",
+    debounce(() => {
+      setupSearchElements(); // re-detect and re-bind search input
+    }, 250),
+  );
   document.addEventListener("keydown", handleGlobalKeyDown);
   document.addEventListener("click", handleGlobalClick);
 
-  // Fetch search data and initialize Fuse
   fetch(SEARCH_FILE)
     .then((response) => {
       if (!response.ok) {
@@ -293,8 +280,15 @@ require(["fuse"], function (Fuse) {
       }
       return response.json();
     })
-    .then((SEARCH_DATA) => initializeFuse(SEARCH_DATA, SEARCH_OPTIONS))
-    .catch((error) =>
-      console.error(`[AST]: Can not fetch ${SEARCH_FILE}`, error.message),
-    );
+    .then((SEARCH_DATA) => {
+      initializeFuse(SEARCH_DATA, SEARCH_OPTIONS);
+    })
+    .catch((error) => {
+      console.error(`[AST]: Cannot fetch ${SEARCH_FILE}`, error.message);
+    });
+
+  function initializeFuse(data, options) {
+    fuse = new Fuse(data, options);
+    document.documentElement.setAttribute("data-fuse_active", "true");
+  }
 });

From b78aef2a9f381b3bd7b2f67f95dd2f66a0f13b01 Mon Sep 17 00:00:00 2001
From: Revathyvenugopal162 <revathy.venugopal@ansys.com>
Date: Fri, 16 May 2025 14:56:16 +0200
Subject: [PATCH 16/16] feat: cleanup and docstrings

---
 .../ansys_sphinx_theme/static/js/search.js    | 131 ++++++++++--------
 1 file changed, 72 insertions(+), 59 deletions(-)

diff --git a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
index 6ee23ab8e..99b55cf77 100644
--- a/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
+++ b/src/ansys_sphinx_theme/theme/ansys_sphinx_theme/static/js/search.js
@@ -11,19 +11,20 @@ let SEARCH_BAR,
   CURRENT_INDEX = -1;
 let fuse;
 
-// Configure Fuse.js path
+// Load Fuse.js from CDN
 require.config({
   paths: {
     fuse: `https://cdn.jsdelivr.net/npm/fuse.js@${FUSE_VERSION}/dist/fuse.min`,
   },
 });
 
-// Load Fuse.js and set up the search system
 require(["fuse"], function (Fuse) {
-  // -------------------------------------
-  // Utility Functions
-  // -------------------------------------
-
+  /**
+   * Debounce function to limit how often a function is called.
+   * @param {Function} func - Function to debounce.
+   * @param {number} delay - Delay in milliseconds.
+   * @returns {Function}
+   */
   const debounce = (func, delay) => {
     let timeout;
     return (...args) => {
@@ -32,29 +33,44 @@ require(["fuse"], function (Fuse) {
     };
   };
 
+  /**
+   * Truncate a long text string to a specified length.
+   * @param {string} text - Text to truncate.
+   * @param {number} maxLength - Maximum allowed length.
+   * @returns {string}
+   */
   const truncateTextPreview = (text, maxLength = 200) =>
     text.length <= maxLength ? text : `${text.slice(0, maxLength)}...`;
 
+  /**
+   * Return full path based on Sphinx's data-content_root.
+   * @param {string} targetFile - Path to file.
+   * @returns {string}
+   */
   const getDynamicPath = (targetFile) => {
     const contentRoot =
       document.documentElement.getAttribute("data-content_root");
     return `${contentRoot}${targetFile}`;
   };
 
+  /**
+   * Navigate to a given URL.
+   * @param {string} href - Target href.
+   */
   const navigateToHref = (href) => {
     window.location.href = getDynamicPath(href);
   };
 
-  // -------------------------------------
-  // UI Handlers
-  // -------------------------------------
-
+  /**
+   * Expand the search input UI.
+   */
   function expandSearchInput() {
     RESULTS.style.display = "flex";
     SEARCH_INPUT.classList.add("expanded");
     MAIN_PAGE_CONTENT.classList.add("blurred");
     SEARCH_INPUT.focus();
-    // 🛠️ Fix overlap on mobile: reduce the opacity of the container
+
+    // Fix overlapping on mobile view
     const modalSidebar = document.querySelector(
       "#pst-primary-sidebar-modal > div.sidebar-primary-items__start.sidebar-primary__section",
     );
@@ -63,12 +79,16 @@ require(["fuse"], function (Fuse) {
     }
   }
 
+  /**
+   * Collapse and reset the search UI.
+   */
   function collapseSearchInput() {
     RESULTS.style.display = "none";
     SEARCH_INPUT.classList.remove("expanded");
     SEARCH_INPUT.value = "";
     MAIN_PAGE_CONTENT.classList.remove("blurred");
     CURRENT_INDEX = -1;
+
     const modalSidebar = document.querySelector(
       "#pst-primary-sidebar-modal > div.sidebar-primary-items__start.sidebar-primary__section",
     );
@@ -77,6 +97,9 @@ require(["fuse"], function (Fuse) {
     }
   }
 
+  /**
+   * Show banner when no results found.
+   */
   function noResultsFoundBanner() {
     RESULTS.innerHTML = "";
     RESULTS.style.display = "flex";
@@ -87,6 +110,9 @@ require(["fuse"], function (Fuse) {
     RESULTS.appendChild(banner);
   }
 
+  /**
+   * Show a temporary searching indicator.
+   */
   function searchingForResultsBanner() {
     RESULTS.innerHTML = "";
     RESULTS.style.display = "flex";
@@ -97,16 +123,15 @@ require(["fuse"], function (Fuse) {
     RESULTS.appendChild(banner);
   }
 
+  /**
+   * Display search results from Fuse.
+   * @param {Array} results - Fuse search result objects.
+   */
   function displayResults(results) {
     RESULTS.innerHTML = "";
-
-    if (results.length === 0) {
-      noResultsFoundBanner();
-      return;
-    }
+    if (results.length === 0) return noResultsFoundBanner();
 
     const fragment = document.createDocumentFragment();
-
     results.forEach(({ item: { title, text, href } }) => {
       const resultItem = document.createElement("div");
       resultItem.className = "result-item";
@@ -130,6 +155,10 @@ require(["fuse"], function (Fuse) {
     RESULTS.style.display = "flex";
   }
 
+  /**
+   * Highlight the currently selected item.
+   * @param {NodeList} resultsItems - List of result items.
+   */
   function focusSelected(resultsItems) {
     if (CURRENT_INDEX >= 0 && CURRENT_INDEX < resultsItems.length) {
       resultsItems.forEach((item) => item.classList.remove("selected"));
@@ -140,27 +169,26 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // -------------------------------------
-  // Search Logic
-  // -------------------------------------
-
+  /**
+   * Handle search query input with debounce.
+   */
   const handleSearchInput = debounce(
     () => {
       const query = SEARCH_INPUT.value.trim();
-      if (!query) {
-        RESULTS.style.display = "none";
-        return;
-      }
+      if (!query) return (RESULTS.style.display = "none");
 
       const searchResults = fuse.search(query, {
         limit: parseInt(SEARCH_OPTIONS.limit),
       });
-
       displayResults(searchResults);
     },
     parseInt(SEARCH_OPTIONS.delay) || 300,
   );
 
+  /**
+   * Handle keyboard navigation inside search input.
+   * @param {KeyboardEvent} event
+   */
   function handleKeyDownSearchInput(event) {
     const resultItems = RESULTS.querySelectorAll(".result-item");
 
@@ -168,11 +196,9 @@ require(["fuse"], function (Fuse) {
       case "Tab":
         event.preventDefault();
         break;
-
       case "Escape":
         collapseSearchInput();
         break;
-
       case "Enter":
         event.preventDefault();
         const indexToNavigate =
@@ -186,14 +212,12 @@ require(["fuse"], function (Fuse) {
           navigateToHref(href);
         }
         break;
-
       case "ArrowDown":
         if (resultItems.length > 0) {
           CURRENT_INDEX = (CURRENT_INDEX + 1) % resultItems.length;
           focusSelected(resultItems);
         }
         break;
-
       case "ArrowUp":
         if (resultItems.length > 0) {
           CURRENT_INDEX =
@@ -201,7 +225,6 @@ require(["fuse"], function (Fuse) {
           focusSelected(resultItems);
         }
         break;
-
       default:
         if (
           document.documentElement.getAttribute("data-fuse_active") === "true"
@@ -215,10 +238,9 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // -------------------------------------
-  // Setup and Events
-  // -------------------------------------
-
+  /**
+   * Initialize and bind search elements.
+   */
   function setupSearchElements() {
     if (window.innerWidth < 1200) {
       SEARCH_BAR = document.querySelector(
@@ -238,19 +260,16 @@ require(["fuse"], function (Fuse) {
     }
 
     SEARCH_INPUT = SEARCH_BAR.querySelector(".bd-search input.form-control");
-
     if (SEARCH_INPUT) {
       SEARCH_INPUT.addEventListener("click", expandSearchInput);
       SEARCH_INPUT.addEventListener("keydown", handleKeyDownSearchInput);
     }
   }
 
+  // Global event listeners
   function handleGlobalKeyDown(event) {
-    if (event.key === "Escape") {
-      collapseSearchInput();
-    } else if (event.key === "k" && event.ctrlKey) {
-      expandSearchInput();
-    }
+    if (event.key === "Escape") collapseSearchInput();
+    else if (event.key === "k" && event.ctrlKey) expandSearchInput();
   }
 
   function handleGlobalClick(event) {
@@ -259,34 +278,28 @@ require(["fuse"], function (Fuse) {
     }
   }
 
-  // -------------------------------------
-  // Initialize
-  // -------------------------------------
-
+  // Initialize search system
   setupSearchElements();
-  window.addEventListener(
-    "resize",
-    debounce(() => {
-      setupSearchElements(); // re-detect and re-bind search input
-    }, 250),
-  );
+  window.addEventListener("resize", debounce(setupSearchElements, 250));
   document.addEventListener("keydown", handleGlobalKeyDown);
   document.addEventListener("click", handleGlobalClick);
 
   fetch(SEARCH_FILE)
     .then((response) => {
-      if (!response.ok) {
+      if (!response.ok)
         throw new Error(`[AST]: HTTPS error ${response.statusText}`);
-      }
       return response.json();
     })
-    .then((SEARCH_DATA) => {
-      initializeFuse(SEARCH_DATA, SEARCH_OPTIONS);
-    })
-    .catch((error) => {
-      console.error(`[AST]: Cannot fetch ${SEARCH_FILE}`, error.message);
-    });
+    .then((SEARCH_DATA) => initializeFuse(SEARCH_DATA, SEARCH_OPTIONS))
+    .catch((error) =>
+      console.error(`[AST]: Cannot fetch ${SEARCH_FILE}`, error.message),
+    );
 
+  /**
+   * Initialize Fuse with the given data and options.
+   * @param {Array} data - Search index data.
+   * @param {Object} options - Fuse.js configuration options.
+   */
   function initializeFuse(data, options) {
     fuse = new Fuse(data, options);
     document.documentElement.setAttribute("data-fuse_active", "true");