docs: compact help topics with accordions

Author: Shik3i

scripts/test-website-theme.mjs

@@ -132,6 +132,32 @@ for (const metadata of requiredHelpMetadata) {
     throw new Error(`help.html is missing SEO/AEO metadata: ${metadata}`);
   }
 }
+const helpStructuredDataMatch = helpPage.match(/<script type="application\/ld\+json">([\s\S]*?)<\/script>/);
+if (!helpStructuredDataMatch) {
+  throw new Error('help.html must contain JSON-LD structured data');
+}
+const helpStructuredData = JSON.parse(helpStructuredDataMatch[1]);
+const helpFaqPage = helpStructuredData['@graph'].find(item => (
+  Array.isArray(item['@type']) && item['@type'].includes('FAQPage')
+));
+const helpVisibleText = helpPage
+  .replace(/<script[\s\S]*?<\/script>/g, ' ')
+  .replace(/<[^>]+>/g, '')
+  .replaceAll('&amp;', '&')
+  .replaceAll('&quot;', '"')
+  .replaceAll('&#39;', "'")
+  .replaceAll('&lt;', '<')
+  .replaceAll('&gt;', '>')
+  .replaceAll('&nbsp;', ' ')
+  .replace(/\s+/g, ' ');
+for (const question of helpFaqPage?.mainEntity || []) {
+  if (!helpVisibleText.includes(question.name) || !helpVisibleText.includes(question.acceptedAnswer?.text)) {
+    throw new Error(`help.html FAQ content must be visible and exact: ${question.name}`);
+  }
+}
+if ((helpPage.match(/class="support-card support-anchor-section support-accordion"/g) || []).length < 10) {
+  throw new Error('help.html must keep advanced and troubleshooting sections compact with native accordions');
+}
 if (!llmsText.includes('[Help Center](https://sync.koalastuff.net/help)')
     || !llmsText.includes('[Website access guide](https://sync.koalastuff.net/site-access-help)')) {
   throw new Error('llms.txt must expose the Help Center and website-access guide');

website/app.js

@@ -1760,6 +1760,20 @@ document.addEventListener('DOMContentLoaded', () => {
     updateDynamicVersion();
     localizeHomeLinks();
     initLanguageSelectorValue();
+    const openSupportAccordion = hash => {
+        if (!hash || hash === '#') return;
+        const target = document.getElementById(decodeURIComponent(hash.slice(1)));
+        if (target?.matches('details.support-accordion')) {
+            target.open = true;
+            window.requestAnimationFrame(() => target.scrollIntoView({ block: 'start' }));
+        }
+    };
+    openSupportAccordion(window.location.hash);
+    window.addEventListener('hashchange', () => openSupportAccordion(window.location.hash));
+    document.addEventListener('click', event => {
+        const link = event.target.closest('a[href^="#"]');
+        if (link) openSupportAccordion(link.hash);
+    });
     if (document.fonts?.ready) {
         document.fonts.ready.then(adjustDropdownWidth);
     }