From 4c42a7aae3f41b312f1191170b632a045ce8039e Mon Sep 17 00:00:00 2001
From: Nikhil Pareek <nick.coolvyas@gmail.com>
Date: Sat, 3 Oct 2026 20:04:24 -0700
Subject: [PATCH 1/3] feat(docs-chat): add Minimize and Restore without
 replacing Close

Close still dismisses the panel and keeps history. Minimize parks the
same conversation behind a Restore chip, remembers the window mode, and
keeps the unsent draft in the tab session.
---
 src/components/AiChatWidget.astro | 87 ++++++++++++++++++++++++++++---
 1 file changed, 79 insertions(+), 8 deletions(-)

diff --git a/src/components/AiChatWidget.astro b/src/components/AiChatWidget.astro
index 4c497458..b8650c16 100644
--- a/src/components/AiChatWidget.astro
+++ b/src/components/AiChatWidget.astro
@@ -71,6 +71,9 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
       <!-- Floating popup icon (shown in sidebar mode) -->
       <svg id="ai-sb-undock" class="w-3.5 h-3.5 hidden" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><rect x="4" y="4" width="12" height="12" rx="2" stroke-linecap="round" stroke-linejoin="round" /><path d="M20 8v12a2 2 0 01-2 2H8" stroke-linecap="round" stroke-linejoin="round" /></svg>
     </button>
+    <button id="ai-minimize-btn" class="p-1 rounded-md text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-hover)] transition-colors cursor-pointer" title="Minimize" aria-label="Minimize AI chat">
+      <svg class="w-3.5 h-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M5 12h14" stroke-linecap="round" /></svg>
+    </button>
     <button id="ai-fullscreen-btn" class="p-1 rounded-md text-[var(--color-text-muted)] hover:text-[var(--color-text-primary)] hover:bg-[var(--color-bg-hover)] transition-colors cursor-pointer" title="Toggle fullscreen">
       <svg id="ai-fs-expand" class="w-3.5 h-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M15 3h6v6M9 21H3v-6M21 3l-7 7M3 21l7-7" stroke-linecap="round" stroke-linejoin="round" /></svg>
       <svg id="ai-fs-shrink" class="w-3.5 h-3.5 hidden" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 14h6v6M20 10h-6V4M14 10l7-7M3 21l7-7" stroke-linecap="round" stroke-linejoin="round" /></svg>
@@ -127,6 +130,12 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
   </div>
 </div>
 
+<button id="ai-restore-chip" type="button" class="hidden fixed z-50 items-center gap-2 rounded-full border border-[var(--color-border-default)] px-3 py-2 text-xs font-medium text-[var(--color-text-primary)] shadow-lg cursor-pointer" style="background:#161616;bottom:24px;right:24px;min-height:44px;min-width:44px;" aria-label="Restore AI chat" title="Restore AI chat">
+  <svg class="w-3.5 h-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 14h6v6M20 10h-6V4M14 10l7-7M3 21l7-7" stroke-linecap="round" stroke-linejoin="round" /></svg>
+  <span>Restore AI chat</span>
+  <span id="ai-restore-status" class="hidden text-[10px] text-purple-300"></span>
+</button>
+
 <script is:inline>
 (function() {
   function setupWidget() {
@@ -150,6 +159,9 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
     var quickBtns = document.querySelectorAll('.ai-wq');
 
     var sidebarBtn = document.getElementById('ai-sidebar-btn');
+    var minimizeBtn = document.getElementById('ai-minimize-btn');
+    var restoreChip = document.getElementById('ai-restore-chip');
+    var restoreStatus = document.getElementById('ai-restore-status');
     var resizeTop = document.getElementById('ai-resize-top');
     var resizeLeft = document.getElementById('ai-resize-left');
 
@@ -248,6 +260,7 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
 
     // Restore state from sessionStorage (persists across Astro page navigations)
     var isOpen = sessionStorage.getItem('ai-chat-open') === 'true';
+    var isMinimized = sessionStorage.getItem('ai-chat-minimized') === 'true';
     var conversationHistory = [];
     try {
       var stored = sessionStorage.getItem('ai-chat-history');
@@ -256,7 +269,19 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
 
     function saveState() {
       sessionStorage.setItem('ai-chat-open', isOpen ? 'true' : 'false');
+      sessionStorage.setItem('ai-chat-minimized', isMinimized ? 'true' : 'false');
       sessionStorage.setItem('ai-chat-history', JSON.stringify(conversationHistory.slice(-20)));
+      if (input) sessionStorage.setItem('ai-chat-draft', input.value);
+    }
+    function syncRestoreChip() {
+      if (!restoreChip) return;
+      if (isMinimized && !isOpen) {
+        restoreChip.classList.remove('hidden');
+        restoreChip.classList.add('flex');
+      } else {
+        restoreChip.classList.add('hidden');
+        restoreChip.classList.remove('flex');
+      }
     }
     function saveMessagesHtml() {
       if (messagesEl) {
@@ -460,7 +485,9 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
 
     function open() {
       isOpen = true;
+      isMinimized = false;
       saveState();
+      syncRestoreChip();
       applyDefault();
       // Lazy-load chat dependencies (marked.js, highlight.js, Turnstile) — await before allowing messages
       if (typeof window.loadChatDeps === 'function') {
@@ -477,10 +504,38 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
       if (input) setTimeout(function() { input.focus(); }, 100);
     }
 
+    function minimize() {
+      if (!isOpen) return;
+      if (isSidebar) exitSidebar();
+      if (isFullscreen) exitFullscreen();
+      var remembered = sessionStorage.getItem('ai-chat-mode') || 'popup';
+      sessionStorage.setItem('ai-chat-restore-mode', remembered);
+      isOpen = false;
+      isMinimized = true;
+      saveState();
+      saveMessagesHtml();
+      popup.style.opacity = '0';
+      popup.style.transform = 'translateY(8px) scale(0.97)';
+      setTimeout(function() { popup.classList.add('hidden'); popup.classList.remove('flex'); popup.style.transition = ''; }, 200);
+      syncRestoreChip();
+      if (restoreChip) restoreChip.focus();
+    }
+
+    function restore() {
+      isMinimized = false;
+      var mode = sessionStorage.getItem('ai-chat-restore-mode') || 'popup';
+      open();
+      if (mode === 'sidebar' && window.innerWidth >= 768) enterSidebar();
+      else if (mode === 'fullscreen') enterFullscreen();
+      saveState();
+    }
+
     function close() {
       if (isFullscreen) exitFullscreen();
       isOpen = false;
+      isMinimized = false;
       saveState();
+      syncRestoreChip();
       popup.style.opacity = '0';
       popup.style.transform = 'translateY(8px) scale(0.97)';
       setTimeout(function() { popup.classList.add('hidden'); popup.classList.remove('flex'); popup.style.transition = ''; }, 200);
@@ -591,20 +646,32 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
       if (isFullscreen) exitFullscreen();
       isSidebar ? exitSidebar() : enterSidebar();
     });
-    if (newChatBtn) newChatBtn.addEventListener('click', resetChat);
+    if (newChatBtn) newChatBtn.addEventListener('click', function() {
+      isMinimized = false;
+      sessionStorage.removeItem('ai-chat-draft');
+      if (input) input.value = '';
+      resetChat();
+      syncRestoreChip();
+    });
+    if (minimizeBtn) minimizeBtn.addEventListener('click', minimize);
+    if (restoreChip) restoreChip.addEventListener('click', restore);
     // Stop button kept for backward compat but send button is primary stop
     if (stopBtn) stopBtn.addEventListener('click', function() { if (currentAbortController) currentAbortController.abort(); });
 
-    window.openAiChat = function() { if (!isOpen) open(); };
+    window.openAiChat = function() {
+      if (isMinimized) restore();
+      else if (!isOpen) open();
+    };
     window._openAiChatInner = function() { if (!isOpen) open(); };
     window.closeAiChat = function() { if (isSidebar) exitSidebar(); if (isOpen) close(); };
 
     document.addEventListener('keydown', function(e) {
-      if (e.key === 'Escape' && isOpen) {
-        if (isFullscreen) exitFullscreen();
-        else if (isSidebar) { exitSidebar(); close(); }
-        else close();
-      }
+      if (e.key !== 'Escape' || !isOpen) return;
+      if (isFullscreen) { exitFullscreen(); return; }
+      var focusInside = popup.contains(document.activeElement);
+      if (!focusInside) return;
+      if (isSidebar) exitSidebar();
+      minimize();
     });
 
     // --- Resize (corner + top edge + left edge) ---
@@ -677,7 +744,9 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
         messagesEl.scrollTop = messagesEl.scrollHeight;
       }
       // Restore open state and mode
-      if (isOpen) {
+      if (isMinimized) {
+        syncRestoreChip();
+      } else if (isOpen) {
         var savedMode = sessionStorage.getItem('ai-chat-mode');
         if (savedMode === 'sidebar') {
           enterSidebar();
@@ -689,6 +758,8 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
         popup.style.opacity = '1';
         popup.style.transform = 'translateY(0) scale(1)';
       }
+      var savedDraft = sessionStorage.getItem('ai-chat-draft');
+      if (input && savedDraft) input.value = savedDraft;
     })();
 
     // ===========================================================

From bee342d850ae0f3080e48ec8866fb614d15e96d9 Mon Sep 17 00:00:00 2001
From: Nikhil Pareek <nick.coolvyas@gmail.com>
Date: Sat, 3 Oct 2026 20:11:15 -0700
Subject: [PATCH 2/3] fix(docs-chat): remember sidebar and fullscreen before
 minimize teardown

Snapshot the live window mode before exitSidebar/exitFullscreen rewrite
storage to popup. Drop the unused restore-status span.
---
 src/components/AiChatWidget.astro | 4 +---
 1 file changed, 1 insertion(+), 3 deletions(-)

diff --git a/src/components/AiChatWidget.astro b/src/components/AiChatWidget.astro
index b8650c16..e4013df7 100644
--- a/src/components/AiChatWidget.astro
+++ b/src/components/AiChatWidget.astro
@@ -133,7 +133,6 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
 <button id="ai-restore-chip" type="button" class="hidden fixed z-50 items-center gap-2 rounded-full border border-[var(--color-border-default)] px-3 py-2 text-xs font-medium text-[var(--color-text-primary)] shadow-lg cursor-pointer" style="background:#161616;bottom:24px;right:24px;min-height:44px;min-width:44px;" aria-label="Restore AI chat" title="Restore AI chat">
   <svg class="w-3.5 h-3.5" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><path d="M4 14h6v6M20 10h-6V4M14 10l7-7M3 21l7-7" stroke-linecap="round" stroke-linejoin="round" /></svg>
   <span>Restore AI chat</span>
-  <span id="ai-restore-status" class="hidden text-[10px] text-purple-300"></span>
 </button>
 
 <script is:inline>
@@ -161,7 +160,6 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
     var sidebarBtn = document.getElementById('ai-sidebar-btn');
     var minimizeBtn = document.getElementById('ai-minimize-btn');
     var restoreChip = document.getElementById('ai-restore-chip');
-    var restoreStatus = document.getElementById('ai-restore-status');
     var resizeTop = document.getElementById('ai-resize-top');
     var resizeLeft = document.getElementById('ai-resize-left');
 
@@ -506,9 +504,9 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
 
     function minimize() {
       if (!isOpen) return;
+      var remembered = isFullscreen ? 'fullscreen' : (isSidebar ? 'sidebar' : 'popup');
       if (isSidebar) exitSidebar();
       if (isFullscreen) exitFullscreen();
-      var remembered = sessionStorage.getItem('ai-chat-mode') || 'popup';
       sessionStorage.setItem('ai-chat-restore-mode', remembered);
       isOpen = false;
       isMinimized = true;

From d792ac3c8d3650f87ceecc469247f39f209a8346 Mon Sep 17 00:00:00 2001
From: Nikhil Pareek <nick.coolvyas@gmail.com>
Date: Wed, 7 Oct 2026 02:16:13 -0700
Subject: [PATCH 3/3] fix(docs-chat): re-dock on Escape restore and drop sent
 text from the draft

Escape while the docked chat had focus undocked it before minimize() could
record the mode, so Restore came back as a popup. minimize() already undocks
after recording the mode; the extra exitSidebar() call is removed.

doSendMessage() saved state before clearing the input, so the question just
sent was stored as the unsent draft and reappeared in the input after a page
navigation while the answer was still streaming. Clear first, then save.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 src/components/AiChatWidget.astro | 5 +++--
 1 file changed, 3 insertions(+), 2 deletions(-)

diff --git a/src/components/AiChatWidget.astro b/src/components/AiChatWidget.astro
index e4013df7..3ee68d03 100644
--- a/src/components/AiChatWidget.astro
+++ b/src/components/AiChatWidget.astro
@@ -668,7 +668,7 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
       if (isFullscreen) { exitFullscreen(); return; }
       var focusInside = popup.contains(document.activeElement);
       if (!focusInside) return;
-      if (isSidebar) exitSidebar();
+      // minimize() records sidebar mode before undocking, so Restore re-docks
       minimize();
     });
 
@@ -797,9 +797,10 @@ const turnstileSiteKey = import.meta.env.PUBLIC_TURNSTILE_SITE_KEY || '';
       // Add user message
       addUserMsg(msg);
       conversationHistory.push({ role: 'user', content: msg });
-      saveState();
+      // Clear before saving so the sent text is not kept as the unsent draft
       input.value = '';
       input.style.height = 'auto';
+      saveState();
 
       // Create message group for assistant response
       var msgGroup = document.createElement('div');