From bd0ec1b01e0cc2cc37856fd4b2f36585240b5f59 Mon Sep 17 00:00:00 2001
From: Jage9 <jj@bestmidi.com>
Date: Sun, 8 Mar 2026 22:18:18 -0400
Subject: [PATCH] Add collapsible footer help panel

---
 client/index.html        |  7 +++++--
 client/public/version.js |  2 +-
 client/src/main.ts       | 25 +++++++++++++++++++++----
 client/src/styles.css    |  9 ++++++++-
 4 files changed, 35 insertions(+), 8 deletions(-)

diff --git a/client/index.html b/client/index.html
index 6d19974..70ba252 100644
--- a/client/index.html
+++ b/client/index.html
@@ -66,13 +66,16 @@
         class="hidden"
         aria-label="Chat Grid, press question mark for help."
       ></canvas>
-      <div id="instructions" class="hidden"></div>
-
       <footer id="appFooter">
         <small id="appVersion">Another AI experiment with Jage. Version</small>
         <small id="appGithubLinkWrap">
           <a id="appGithubLink" href="https://www.github.com/jage9/chat_grid">Chat Grid on Github</a>
         </small>
+        <section id="helpSection" class="updates-section hidden">
+          <h2>Help</h2>
+          <button id="helpToggle" type="button" aria-expanded="false" aria-controls="instructions">Show help</button>
+          <div id="instructions" class="hidden" hidden></div>
+        </section>
         <section id="updatesSection" class="updates-section">
           <h2>Latest Updates</h2>
           <button id="updatesToggle" type="button" aria-expanded="false" aria-controls="updatesPanel">
diff --git a/client/public/version.js b/client/public/version.js
index 69d46b3..a6ba1d7 100644
--- a/client/public/version.js
+++ b/client/public/version.js
@@ -1,6 +1,6 @@
 // Maintainer-controlled web client version metadata.
 window.CHGRID_RELEASE_VERSION = "0.1.0";
-window.CHGRID_BUILD_REVISION = "R340";
+window.CHGRID_BUILD_REVISION = "R341";
 window.CHGRID_WEB_VERSION = `${window.CHGRID_RELEASE_VERSION} ${window.CHGRID_BUILD_REVISION}`;
 // Optional display timezone for timestamps. Falls back to America/Detroit if unset/invalid.
 window.CHGRID_TIME_ZONE = "America/Detroit";
diff --git a/client/src/main.ts b/client/src/main.ts
index a4acd0a..7c9a217 100644
--- a/client/src/main.ts
+++ b/client/src/main.ts
@@ -113,6 +113,8 @@ type Dom = {
   authSessionText: HTMLParagraphElement;
   authModeSeparator: HTMLElement;
   showRegisterButton: HTMLButtonElement;
+  helpSection: HTMLElement;
+  helpToggle: HTMLButtonElement;
   updatesSection: HTMLElement;
   updatesToggle: HTMLButtonElement;
   updatesPanel: HTMLDivElement;
@@ -148,6 +150,8 @@ const dom: Dom = {
   authSessionText: requiredById('authSessionText'),
   authModeSeparator: requiredById('authModeSeparator'),
   showRegisterButton: requiredById('showRegisterButton'),
+  helpSection: requiredById('helpSection'),
+  helpToggle: requiredById('helpToggle'),
   updatesSection: requiredById('updatesSection'),
   updatesToggle: requiredById('updatesToggle'),
   updatesPanel: requiredById('updatesPanel'),
@@ -435,13 +439,18 @@ function setUpdatesExpanded(expanded: boolean): void {
   dom.updatesPanel.classList.toggle('hidden', !expanded);
 }
 
+/** Toggles help panel visibility and syncs associated ARIA state. */
+function setHelpExpanded(expanded: boolean): void {
+  dom.helpToggle.setAttribute('aria-expanded', expanded ? 'true' : 'false');
+  dom.helpToggle.textContent = expanded ? 'Hide help' : 'Show help';
+  dom.instructions.hidden = !expanded;
+  dom.instructions.classList.toggle('hidden', !expanded);
+}
+
 /** Renders help sections into the footer help container and builds linearized viewer lines. */
 function renderHelp(help: HelpData): void {
   const lines = buildHelpLines(help);
   dom.instructions.innerHTML = '';
-  const heading = document.createElement('h2');
-  heading.textContent = 'Help';
-  dom.instructions.appendChild(heading);
   for (const section of help.sections) {
     const sectionHeading = document.createElement('h3');
     sectionHeading.textContent = section.title;
@@ -458,6 +467,8 @@ function renderHelp(help: HelpData): void {
   mainHelpViewerLines = lines;
   helpViewerLines = lines;
   helpViewerIndex = 0;
+  dom.helpSection.classList.remove('hidden');
+  setHelpExpanded(false);
 }
 
 /** Loads runtime help content from `help.json` and applies it when available. */
@@ -465,15 +476,21 @@ async function loadHelp(): Promise<void> {
   try {
     const response = await fetch(withBase('help.json'), { cache: 'no-store' });
     if (!response.ok) {
+      dom.helpSection.classList.add('hidden');
       return;
     }
     const help = (await response.json()) as HelpData;
     if (!Array.isArray(help.sections) || help.sections.length === 0) {
+      dom.helpSection.classList.add('hidden');
       return;
     }
     renderHelp(help);
+    dom.helpToggle.addEventListener('click', () => {
+      const expanded = dom.helpToggle.getAttribute('aria-expanded') === 'true';
+      setHelpExpanded(!expanded);
+    });
   } catch {
-    // Keep existing/static help if loading fails.
+    dom.helpSection.classList.add('hidden');
   }
 }
 
diff --git a/client/src/styles.css b/client/src/styles.css
index f25d6e2..a100d56 100644
--- a/client/src/styles.css
+++ b/client/src/styles.css
@@ -60,6 +60,7 @@ body {
   margin: 0.35rem 0;
 }
 
+#helpToggle,
 #updatesToggle {
   margin-bottom: 0.35rem;
 }
@@ -202,10 +203,16 @@ canvas {
 #instructions {
   color: #94a3b8;
   text-align: left;
-  margin: 0.75rem auto;
+  margin: 0.35rem auto 0;
   width: fit-content;
 }
 
+#instructions h3 {
+  color: #cbd5e1;
+  font-size: 0.95rem;
+  margin: 0.35rem 0 0.2rem;
+}
+
 .hidden {
   display: none !important;
 }