fix(docs): resolve internal .md links, dark theme button contrast, and add collapsible sidebar groups

Author: nabeghe

docs/assets/docs.css

@@ -4,8 +4,14 @@
 .sidebar-brand{margin-bottom:var(--space-6)}
 .sidebar-brand a{display:flex;align-items:center;gap:var(--space-2);font:700 var(--text-base) var(--font-display)}
 .sidebar-nav{display:flex;flex-direction:column;gap:var(--space-1)}
+
 .side-group{margin-top:var(--space-4)}
-.side-group-title{font-size:var(--text-xs);text-transform:uppercase;letter-spacing:.08em;color:var(--color-text-faint);margin:0 var(--space-3) var(--space-2)}
+.side-group-header{display:flex;align-items:center;justify-content:space-between;width:100%;padding:var(--space-2) var(--space-3);cursor:pointer;background:none;border:0;border-radius:var(--radius-lg);font-size:var(--text-xs);text-transform:uppercase;letter-spacing:.08em;color:var(--color-text-faint);font-weight:700;transition:background var(--transition-interactive)}
+.side-group-header:hover{background:var(--color-surface-2);color:var(--color-text-muted)}
+.side-group-header .chevron{display:inline-block;transition:transform .18s ease;font-size:.8em}
+.side-group.collapsed .chevron{transform:rotate(-90deg)}
+.side-group-items{display:flex;flex-direction:column;gap:var(--space-1);overflow:hidden;max-height:1000px;transition:max-height .25s ease}
+.side-group.collapsed .side-group-items{max-height:0}
 .side-link{display:block;padding:var(--space-2) var(--space-3);border-radius:var(--radius-lg);font-size:var(--text-sm);color:var(--color-text-muted);transition:all var(--transition-interactive)}
 .side-link:hover{background:var(--color-surface-2);color:var(--color-text)}
 .side-link.active{background:var(--color-primary);color:var(--color-text-inverse);font-weight:600}

docs/assets/style.css

@@ -21,34 +21,46 @@
     </div>
     <nav class="sidebar-nav">
 <a class="side-link active" href="00-index.html">Home</a>
-<div class="side-group"><div class="side-group-title">Getting Started</div>
+<div class="side-group collapsed" data-group="group-0">
+<button type="button" class="side-group-header" data-group-toggle="group-0"><span>Getting Started</span><span class="chevron">&#9660;</span></button>
+<div class="side-group-items">
 <a class="side-link" href="01-installation.html">Installation</a>
 <a class="side-link" href="02-configuration.html">Configuration</a>
-</div>
-<div class="side-group"><div class="side-group-title">Core Architecture</div>
+</div></div>
+<div class="side-group collapsed" data-group="group-1">
+<button type="button" class="side-group-header" data-group-toggle="group-1"><span>Core Architecture</span><span class="chevron">&#9660;</span></button>
+<div class="side-group-items">
 <a class="side-link" href="03-architecture.html">Kernel & Boot Lifecycle</a>
 <a class="side-link" href="04-activities-and-intents.html">Activities & Intents</a>
 <a class="side-link" href="05-views-and-widgets.html">Views & Widgets</a>
 <a class="side-link" href="06-viewmodel-and-state.html">ViewModel & State</a>
-</div>
-<div class="side-group"><div class="side-group-title">Data & Infrastructure</div>
+</div></div>
+<div class="side-group collapsed" data-group="group-2">
+<button type="button" class="side-group-header" data-group-toggle="group-2"><span>Data & Infrastructure</span><span class="chevron">&#9660;</span></button>
+<div class="side-group-items">
 <a class="side-link" href="07-database-and-doctrine.html">Database & Doctrine</a>
 <a class="side-link" href="08-caching-and-redis.html">Caching & Redis</a>
-</div>
-<div class="side-group"><div class="side-group-title">Extensibility</div>
+</div></div>
+<div class="side-group collapsed" data-group="group-3">
+<button type="button" class="side-group-header" data-group-toggle="group-3"><span>Extensibility</span><span class="chevron">&#9660;</span></button>
+<div class="side-group-items">
 <a class="side-link" href="09-plugins.html">Plugin System</a>
 <a class="side-link" href="10-broadcasts.html">Broadcasts</a>
-</div>
-<div class="side-group"><div class="side-group-title">Telegram Integration</div>
+</div></div>
+<div class="side-group collapsed" data-group="group-4">
+<button type="button" class="side-group-header" data-group-toggle="group-4"><span>Telegram Integration</span><span class="chevron">&#9660;</span></button>
+<div class="side-group-items">
 <a class="side-link" href="11-transport-webhook-and-polling.html">Webhook & Polling</a>
 <a class="side-link" href="12-telegram-api-reference.html">Telegram API Reference</a>
-</div>
-<div class="side-group"><div class="side-group-title">Other Topics</div>
+</div></div>
+<div class="side-group collapsed" data-group="group-5">
+<button type="button" class="side-group-header" data-group-toggle="group-5"><span>Other Topics</span><span class="chevron">&#9660;</span></button>
+<div class="side-group-items">
 <a class="side-link" href="13-localization.html">Localization (i18n)</a>
 <a class="side-link" href="14-testing.html">Testing</a>
 <a class="side-link" href="15-deployment.html">Deployment</a>
 <a class="side-link" href="16-advanced-features.html">Advanced Features</a>
-</div>
+</div></div>
 </nav>
   </aside>
   <main id="content" class="docs-content">
@@ -60,37 +72,37 @@ <h1 id="aicriontandroid-documentation">Aicrion\Tandroid Documentation</h1>
 is the recommended learning path.</p>
 <h2 id="getting-started">Getting Started</h2>
 <ul>
-<li><a href="01-installation.md">Installation</a></li>
-<li><a href="02-configuration.md">Configuration</a></li>
+<li><a href="01-installation.html">Installation</a></li>
+<li><a href="02-configuration.html">Configuration</a></li>
 </ul>
 <h2 id="core-architecture">Core Architecture</h2>
 <ul>
-<li><a href="03-architecture.md">The Kernel and the Boot Lifecycle</a></li>
-<li><a href="04-activities-and-intents.md">Activities and Intents</a></li>
-<li><a href="05-views-and-widgets.md">Views and Widgets</a></li>
-<li><a href="06-viewmodel-and-state.md">ViewModel and State Management</a></li>
+<li><a href="03-architecture.html">The Kernel and the Boot Lifecycle</a></li>
+<li><a href="04-activities-and-intents.html">Activities and Intents</a></li>
+<li><a href="05-views-and-widgets.html">Views and Widgets</a></li>
+<li><a href="06-viewmodel-and-state.html">ViewModel and State Management</a></li>
 </ul>
 <h2 id="data-and-infrastructure">Data and Infrastructure</h2>
 <ul>
-<li><a href="07-database-and-doctrine.md">Database and Doctrine</a></li>
-<li><a href="08-caching-and-redis.md">Caching and Redis</a></li>
+<li><a href="07-database-and-doctrine.html">Database and Doctrine</a></li>
+<li><a href="08-caching-and-redis.html">Caching and Redis</a></li>
 </ul>
 <h2 id="extensibility">Extensibility</h2>
 <ul>
-<li><a href="09-plugins.md">Plugin System (Package Manager)</a></li>
-<li><a href="10-broadcasts.md">Broadcasts and System-Wide Events</a></li>
+<li><a href="09-plugins.html">Plugin System (Package Manager)</a></li>
+<li><a href="10-broadcasts.html">Broadcasts and System-Wide Events</a></li>
 </ul>
 <h2 id="connecting-to-telegram">Connecting to Telegram</h2>
 <ul>
-<li><a href="11-transport-webhook-and-polling.md">Webhook and Polling Modes</a></li>
-<li><a href="12-telegram-api-reference.md">Complete Telegram API Reference</a></li>
+<li><a href="11-transport-webhook-and-polling.html">Webhook and Polling Modes</a></li>
+<li><a href="12-telegram-api-reference.html">Complete Telegram API Reference</a></li>
 </ul>
 <h2 id="other-features">Other Features</h2>
 <ul>
-<li><a href="13-localization.md">Localization (i18n)</a></li>
-<li><a href="14-testing.md">Testing</a></li>
-<li><a href="15-deployment.md">Deployment: Shared Hosting and VPS</a></li>
-<li><a href="16-advanced-features.md">Advanced Features: Remote Intents, Guest Mode, Managed Bots</a></li>
+<li><a href="13-localization.html">Localization (i18n)</a></li>
+<li><a href="14-testing.html">Testing</a></li>
+<li><a href="15-deployment.html">Deployment: Shared Hosting and VPS</a></li>
+<li><a href="16-advanced-features.html">Advanced Features: Remote Intents, Guest Mode, Managed Bots</a></li>
 </ul>
 <h2 id="quick-reference">Quick Reference</h2>
 <table>
@@ -105,52 +117,52 @@ <h2 id="quick-reference">Quick Reference</h2>
 <tr>
 <td><code>Activity</code></td>
 <td><code>Activity\BotActivity</code></td>
-<td><a href="04-activities-and-intents.md">Activities and Intents</a></td>
+<td><a href="04-activities-and-intents.html">Activities and Intents</a></td>
 </tr>
 <tr>
 <td><code>Intent</code> / <code>IntentFilter</code></td>
 <td><code>Intent\Intent</code> / <code>Attribute\IntentFilter</code></td>
-<td><a href="04-activities-and-intents.md">Activities and Intents</a></td>
+<td><a href="04-activities-and-intents.html">Activities and Intents</a></td>
 </tr>
 <tr>
 <td><code>ActivityManagerService</code></td>
 <td><code>Kernel\ActivityManager</code></td>
-<td><a href="03-architecture.md">The Kernel</a></td>
+<td><a href="03-architecture.html">The Kernel</a></td>
 </tr>
 <tr>
 <td><code>PackageManagerService</code></td>
 <td><code>Package\PackageManager</code></td>
-<td><a href="09-plugins.md">Plugins</a></td>
+<td><a href="09-plugins.html">Plugins</a></td>
 </tr>
 <tr>
 <td><code>AndroidManifest.xml</code></td>
 <td>each plugin's <code>Package\Manifest</code></td>
-<td><a href="09-plugins.md">Plugins</a></td>
+<td><a href="09-plugins.html">Plugins</a></td>
 </tr>
 <tr>
 <td><code>View</code> / <code>Widget</code></td>
 <td><code>View\View</code> / <code>Widget\*</code></td>
-<td><a href="05-views-and-widgets.md">Views and Widgets</a></td>
+<td><a href="05-views-and-widgets.html">Views and Widgets</a></td>
 </tr>
 <tr>
 <td><code>androidx.lifecycle.ViewModel</code></td>
 <td><code>Kernel\ViewModel\ViewModel</code></td>
-<td><a href="06-viewmodel-and-state.md">ViewModel</a></td>
+<td><a href="06-viewmodel-and-state.html">ViewModel</a></td>
 </tr>
 <tr>
 <td><code>BroadcastReceiver</code></td>
 <td><code>Attribute\BroadcastFilter</code></td>
-<td><a href="10-broadcasts.md">Broadcasts</a></td>
+<td><a href="10-broadcasts.html">Broadcasts</a></td>
 </tr>
 <tr>
 <td>Back Stack</td>
 <td><code>Kernel\BackStackStore</code></td>
-<td><a href="03-architecture.md">The Kernel</a></td>
+<td><a href="03-architecture.html">The Kernel</a></td>
 </tr>
 <tr>
 <td>Navigation Deep Links</td>
 <td><code>Kernel\DeepLinkResolver</code></td>
-<td><a href="04-activities-and-intents.md">Activities and Intents</a></td>
+<td><a href="04-activities-and-intents.html">Activities and Intents</a></td>
 </tr>
 </tbody>
 </table>
@@ -168,11 +180,33 @@ <h2 id="found-a-bug">Found a bug?</h2>
 <script>
 (function(){
   const r=document.documentElement,t=document.querySelector('[data-theme-toggle]');
-  let d=matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light';
+  let d=localStorage.getItem('aicrion-theme')||(matchMedia('(prefers-color-scheme: dark)').matches?'dark':'light');
   r.setAttribute('data-theme',d);
-  t&&t.addEventListener('click',()=>{d=d==='dark'?'light':'dark';r.setAttribute('data-theme',d);});
+  t&&t.addEventListener('click',()=>{
+    d=d==='dark'?'light':'dark';
+    r.setAttribute('data-theme',d);
+    localStorage.setItem('aicrion-theme',d);
+  });
+
   const s=document.querySelector('[data-sidebar]'),st=document.querySelector('[data-sidebar-toggle]');
   st&&st.addEventListener('click',()=>s.classList.toggle('open'));
+
+  const STORAGE_KEY='aicrion-sidebar-groups';
+  let groupState={};
+  try { groupState=JSON.parse(localStorage.getItem(STORAGE_KEY)||'{}'); } catch(e) {}
+
+  document.querySelectorAll('[data-group-toggle]').forEach(function(btn){
+    const id=btn.getAttribute('data-group-toggle');
+    const group=btn.closest('.side-group');
+    if (Object.prototype.hasOwnProperty.call(groupState, id)) {
+      group.classList.toggle('collapsed', groupState[id]===true);
+    }
+    btn.addEventListener('click',function(){
+      const collapsed=group.classList.toggle('collapsed');
+      groupState[id]=collapsed;
+      localStorage.setItem(STORAGE_KEY, JSON.stringify(groupState));
+    });
+  });
 })();
 </script>
 </body>