/* ═══════════ 文档页逻辑（docs.html） ═══════════
   hash 路由（#01-quick-start 可直链某篇）+ fetch content/*.md + marked 前端渲染。
   文档为站点自有的可信 markdown，无需注入消毒。 */
(function () {
  'use strict';

  /* 文档页自己掌控滚动：禁用浏览器滚动恢复。否则刷新时浏览器恢复到上次滚动位置，
     若上次停在 topbar 高度附近，fixed 顶栏会遮住 h1 上半截（实测实踩）；
     切篇/刷新统一回顶，行为可预期。 */
  if ('scrollRestoration' in history) history.scrollRestoration = 'manual';

  /* 目录标题与 md 一级标题语义一致（08/09 目录用简称，正文原标题保留） */
  var DOCS = [
    { id: '01-quick-start', title: '快速上手', file: '01-quick-start.md' },
    { id: '02-core-concepts', title: '核心概念', file: '02-core-concepts.md' },
    { id: '03-conversations', title: '对话', file: '03-conversations.md' },
    { id: '04-input-context', title: '输入与上下文', file: '04-input-context.md' },
    { id: '05-execution-security', title: '执行与安全', file: '05-execution-security.md' },
    { id: '06-conversation-assets', title: '对话资产管理', file: '06-conversation-assets.md' },
    { id: '07-agent-capabilities', title: '智能体能力', file: '07-agent-capabilities.md' },
    { id: '08-quick-dock', title: '快捷窗口', file: '08-quick-dock.md' },
    { id: '09-settings', title: '个人空间设置', file: '09-settings.md' },
    { id: '10-cli', title: 'CLI（开发中）', file: '10-cli.md' }
  ];

  var navEl = document.getElementById('docsNav');
  var contentEl = document.getElementById('docsContent');
  var currentId = null;
  var loadSeq = 0; /* 防快速切换时旧响应覆盖新内容 */

  /* 建左侧目录 */
  DOCS.forEach(function (doc) {
    var a = document.createElement('a');
    a.href = '#' + doc.id;
    a.textContent = doc.title;
    a.dataset.docId = doc.id;
    navEl.appendChild(a);
  });

  function docById(id) {
    for (var i = 0; i < DOCS.length; i++) if (DOCS[i].id === id) return DOCS[i];
    return null;
  }

  /* hash → doc id；不匹配时：尚未加载过 → 默认第一篇；已加载 → 返回 null 忽略
     （可能是渲染内容里的锚点 hash，不应触发切篇） */
  function docIdFromHash() {
    var h = (location.hash || '').replace(/^#\/?/, '');
    if (docById(h)) return h;
    return currentId === null ? DOCS[0].id : null;
  }

  function renderNav() {
    var links = navEl.querySelectorAll('a');
    for (var i = 0; i < links.length; i++) {
      links[i].classList.toggle('active', links[i].dataset.docId === currentId);
    }
  }

  function postProcess() {
    /* 外部链接新标签打开；内容区内的站外相对链接（如指向主仓库文件）在官网无意义，原样保留 */
    var links = contentEl.querySelectorAll('a[href^="http"]');
    for (var i = 0; i < links.length; i++) {
      links[i].setAttribute('target', '_blank');
      links[i].setAttribute('rel', 'noopener');
    }
  }

  function loadDoc(id) {
    var doc = docById(id);
    if (!doc) return;
    currentId = id;
    renderNav();
    var seq = ++loadSeq;
    contentEl.innerHTML = '<p class="docs-loading">加载中…</p>';
    fetch('content/' + doc.file)
      .then(function (res) {
        if (!res.ok) throw new Error('HTTP ' + res.status);
        return res.text();
      })
      .then(function (md) {
        if (seq !== loadSeq) return; /* 期间已切到别的篇目 */
        contentEl.innerHTML = marked.parse(md);
        postProcess();
        window.scrollTo(0, 0);
      })
      .catch(function (err) {
        if (seq !== loadSeq) return;
        contentEl.innerHTML = '<p class="docs-error">文档加载失败（' + String(err) + '）。请刷新重试。</p>';
      });
  }

  window.addEventListener('hashchange', function () {
    var id = docIdFromHash();
    if (id && id !== currentId) loadDoc(id);
  });

  var first = docIdFromHash();
  if (location.hash !== '#' + first) {
    /* 把默认篇目写进地址栏，刷新/分享行为一致 */
    history.replaceState(null, '', '#' + first);
  }
  loadDoc(first);
})();