/* ==========================================================================
   docs.css — 文档站私有样式（2026-09 改版）

   只服务 /docs。骨架：左侧 260px 粘性目录 + 右侧正文（最宽 820）。
   令牌与组件全部来自 app.css；这里只写布局、目录、正文字阶与几处文档专用的小件。
   选择器一律带 docs- 前缀，或限定在 .docs-main / .docs-nav 之下，避免跨页撞名。
   ========================================================================== */

/* -- 01 布局 ---------------------------------------------------------------- */
.docs-shell{padding-top:32px;padding-bottom:88px}
.docs-layout{
  display:grid;
  grid-template-columns:260px minmax(0,820px);
  gap:48px;align-items:start;
}
.docs-main{min-width:0;font-size:14.5px;line-height:1.7}

/* -- 02 左侧目录 ------------------------------------------------------------ */
.docs-nav{
  position:sticky;top:calc(var(--hdr-h) + 20px);
  max-height:calc(100vh - var(--hdr-h) - 40px);
  overflow-y:auto;overscroll-behavior:contain;
  padding:0 10px 24px 0;scrollbar-width:thin;
}
.docs-nav-d > summary{display:none}
.docs-nav-sum{
  list-style:none;cursor:pointer;
  display:flex;align-items:center;gap:9px;
  padding:11px 14px;font-size:14px;font-weight:600;color:var(--text);
  border-radius:var(--r-lg);
}
.docs-nav-sum::-webkit-details-marker{display:none}
.docs-nav-sum .ico{width:17px;height:17px;color:var(--text-3)}
.docs-nav-chev{transition:transform .2s var(--ease)}
.docs-nav-d[open] > .docs-nav-sum .docs-nav-chev{transform:rotate(180deg)}

.docs-search{position:relative;margin-bottom:4px}
.docs-search input{
  width:100%;height:36px;padding:0 30px 0 34px;
  border:1px solid var(--border-str);border-radius:var(--r);
  background:var(--surface);color:var(--text);font-size:13px;
  box-shadow:var(--shadow-xs);transition:border-color .15s,box-shadow .15s;
}
.docs-search input::placeholder{color:var(--text-4)}
.docs-search input:focus{outline:0;border-color:var(--brand-3);box-shadow:0 0 0 3px var(--brand-soft2)}
.docs-search input::-webkit-search-cancel-button{-webkit-appearance:none;appearance:none}
.docs-search > .ico{
  position:absolute;left:11px;top:50%;margin-top:-8px;
  width:16px;height:16px;color:var(--text-3);pointer-events:none;
}
.docs-search kbd{
  position:absolute;right:9px;top:50%;margin-top:-9px;
  font-family:var(--font-mono);font-size:10.5px;font-weight:600;line-height:1;color:var(--text-3);
  border:1px solid var(--border);border-radius:4px;padding:3px 5px;
  background:var(--surface-2);pointer-events:none;
}
.docs-search-count{min-height:18px;margin-bottom:8px;padding:0 2px;font-size:11.5px;color:var(--text-3)}

.docs-group{margin-bottom:14px}
.docs-group[hidden]{display:none}
.docs-group-t{
  font-size:11px;font-weight:650;letter-spacing:.08em;text-transform:uppercase;
  color:var(--text-4);padding:0 10px;margin-bottom:4px;
}
.docs-nav-list{display:flex;flex-direction:column;gap:1px}
.docs-nav-list a{
  position:relative;display:block;
  padding:6px 10px 6px 14px;border-radius:var(--r-sm);
  font-size:13px;line-height:1.45;color:var(--text-2);
  word-break:keep-all;overflow-wrap:anywhere;
  transition:color .15s,background-color .15s;
}
.docs-nav-list a[hidden]{display:none}
.docs-nav-list a::before{
  content:"";position:absolute;left:0;top:7px;bottom:7px;width:2px;border-radius:2px;
  background:transparent;transition:background-color .15s;
}
.docs-nav-list a:hover{color:var(--text);background:var(--surface-2);text-decoration:none}
.docs-nav-list a.on{color:var(--brand);background:var(--brand-soft);font-weight:600}
.docs-nav-list a.on::before{background:var(--brand)}
.docs-nav-list a.sub{padding-left:26px;font-size:12.5px;color:var(--text-3)}
.docs-nav-list a.sub::before{left:14px;top:50%;bottom:auto;width:4px;height:4px;margin-top:-2px;border-radius:50%;background:var(--border-str)}
.docs-nav-list a.sub:hover{color:var(--text)}
.docs-nav-list a.sub.on::before{background:var(--brand)}
.docs-nav-empty{padding:8px 10px;font-size:12.5px;color:var(--text-3)}
.docs-nav-foot{
  margin-top:6px;padding:12px 10px 0;border-top:1px solid var(--border);
  display:flex;flex-direction:column;gap:6px;font-size:12.5px;
}
.docs-nav-foot a{color:var(--text-3)}
.docs-nav-foot a:hover{color:var(--link)}

/* -- 03 正文字阶与章节 ------------------------------------------------------ */
.docs-main .page-head{margin-bottom:8px}
.docs-main .page-head p{max-width:none;font-size:15px}
.docs-main > section{margin-top:40px;padding-top:32px;border-top:1px solid var(--border)}
.docs-main > section:first-of-type{margin-top:0;padding-top:0;border-top:0}
.docs-main h2{
  display:flex;align-items:baseline;gap:6px;flex-wrap:wrap;
  font-size:22px;letter-spacing:-.015em;margin:0 0 12px;word-break:keep-all;
}
.docs-main h3{font-size:16px;margin:28px 0 10px;word-break:keep-all}
.docs-main h3:first-child{margin-top:0}
.docs-main p,.docs-main li{color:var(--text-2)}
.docs-main p{margin:0 0 14px}
.docs-main ul,.docs-main ol{margin:0 0 16px}
.docs-main li{margin:.3em 0}
.docs-main strong{color:var(--text)}
.docs-main .note,.docs-main .alert{margin:0 0 16px}
.docs-main .alert{font-size:14px}
.docs-main .note{font-size:13.5px;line-height:1.65}
.docs-main .steps{margin:0 0 20px}
.docs-main .steps li{font-size:14px;line-height:1.65}
.docs-main .steps li b{margin-bottom:3px}
.docs-main .steps li code{font-size:.9em}
.docs-main .small{font-size:13px}

/* 标题锚点（由 app.js initHeadingAnchors 注入的 button.anchor；app.css 未提供样式，建议进基础层） */
.docs-main .anchor{
  border:0;background:none;padding:0 4px;margin:0;
  font-family:var(--font-mono);font-size:.6em;font-weight:500;line-height:1;
  color:var(--text-3);opacity:0;cursor:pointer;
  transition:opacity .15s,color .15s;
}
.docs-main h2:hover .anchor,.docs-main h3:hover .anchor,.docs-main .anchor:focus-visible{opacity:1}
.docs-main .anchor:hover{color:var(--link)}
@media (hover:none){.docs-main .anchor{opacity:.55}}

/* -- 04 代码块 / 终端块 ----------------------------------------------------- */
.docs-main .code{margin:0 0 16px}
.docs-main .code pre{font-size:12.75px}
.docs-main .code-lg pre{font-size:15px;line-height:1.6}
.docs-install{border-color:var(--brand-soft2);box-shadow:var(--shadow-sm)}
.docs-install .code-bar{background:var(--brand-soft)}
.docs-install .code-lang.plain{color:var(--brand)}
/* 这句话是拿来复制的，手机上按词折行比横滚友好 */
.docs-install pre{white-space:pre-wrap;overflow-wrap:anywhere}
.docs-main .code-bar .copy-btn{white-space:nowrap}
.docs-main .term{font-size:12.75px;margin:0 0 16px}
.docs-main .term .a{color:var(--gold-2)}
.docs-main .term b{color:var(--deep-text);font-weight:620}
.docs-main .term .faint{color:var(--deep-text-3)}

/* -- 05 endpoint 胶囊 / 表格 ------------------------------------------------ */
.docs-eps{display:flex;flex-wrap:wrap;gap:8px;margin:0 0 16px}
.docs-ep{
  display:inline-flex;align-items:center;gap:8px;max-width:100%;min-width:0;
  padding:4px 4px 4px 12px;border:1px solid var(--border);border-radius:var(--r-pill);
  background:var(--surface);font-size:13px;
}
.docs-ep b{color:var(--text);font-weight:620;white-space:nowrap}
.docs-ep .u{
  font-family:var(--font-mono);font-size:12.25px;color:var(--text-2);
  min-width:0;overflow:hidden;text-overflow:ellipsis;white-space:nowrap;
}
.docs-ep .btn{height:26px;padding:0 10px;font-size:12px;border-radius:var(--r-pill);flex:none}

.docs-main .table-wrap{
  margin:0 0 16px;border:1px solid var(--border);border-radius:var(--r-lg);
  background:var(--surface);
}
.docs-main .table th:first-child,.docs-main .table td:first-child{padding-left:16px}
.docs-main .table th:last-child,.docs-main .table td:last-child{padding-right:16px}
.docs-main .table td{vertical-align:top;line-height:1.6}
.docs-main .table .wrap{min-width:180px}
.docs-main .table code{font-size:.9em;white-space:nowrap}
.docs-trouble td:first-child{white-space:nowrap}
.docs-main .docs-trouble .wrap{min-width:230px}
.docs-trouble .badge{vertical-align:middle;margin-right:2px}

/* -- 06 客户端 tabs ---------------------------------------------------------- */
.docs-clients .tablist{margin-bottom:18px}
.docs-clients .tab{padding:0 12px}
.docs-clients .tabpanel > p:first-of-type{margin-bottom:12px}
.docs-panel-t{display:none}
.docs-panel-foot{
  display:flex;flex-wrap:wrap;gap:6px 18px;margin:0 0 6px;
  font-size:13px;color:var(--text-3);
}
.docs-panel-foot strong{color:var(--text-2)}
.docs-keyhint{margin-top:-4px}
/* 无 JS：tabs 退化为顺序展示，每块用自己的标题分隔 */
html:not(.js) .docs-clients .tablist{display:none}
html:not(.js) .docs-clients .tabpanel[hidden]{display:block}
html:not(.js) .docs-panel-t{display:block;margin-top:24px;padding-top:16px;border-top:1px dashed var(--border)}

/* -- 07 执行器两条路径 / 协议两张卡 / 收尾 ---------------------------------- */
.docs-paths{display:grid;grid-template-columns:minmax(0,1fr);gap:16px;margin:0 0 8px}
.docs-paths .card,.docs-traffic .card{min-width:0}
.docs-paths .card-pad{padding:18px 20px}
.docs-path-h{margin-bottom:8px;font-size:14.5px}
.docs-path-h strong{color:var(--text)}
.docs-paths .term,.docs-traffic .card .small{font-size:12.75px}
.docs-traffic{margin-bottom:16px}
.docs-traffic .card-pad{padding:18px 20px}
.docs-traffic ul{padding-left:1.2em}
.docs-traffic li{margin:.2em 0}
.docs-end{
  display:flex;align-items:center;gap:10px;flex-wrap:wrap;
  margin-top:48px;padding-top:20px;border-top:1px solid var(--border);
}

/* -- 08 响应式 --------------------------------------------------------------- */
@media (max-width:1100px){
  .docs-layout{grid-template-columns:224px minmax(0,1fr);gap:36px}
}
@media (max-width:900px){
  .docs-shell{padding-top:20px;padding-bottom:64px}
  .docs-layout{grid-template-columns:minmax(0,1fr);gap:0}
  .docs-nav{
    position:static;max-height:none;overflow:visible;
    padding:0;margin-bottom:24px;
    border:1px solid var(--border);border-radius:var(--r-lg);
    background:var(--surface);box-shadow:var(--shadow-xs);
  }
  .docs-nav-d > summary{display:flex}
  .docs-nav-d[open] > .docs-nav-sum{border-bottom:1px solid var(--border);border-radius:var(--r-lg) var(--r-lg) 0 0}
  .docs-nav-body{padding:12px 12px 10px}
  .docs-search kbd{display:none}
  .docs-search input{padding-right:12px}
  .docs-group{margin-bottom:10px}
  .docs-nav-list{flex-direction:row;flex-wrap:wrap;gap:4px}
  .docs-nav-list a{padding:6px 10px;border:1px solid var(--border);border-radius:var(--r-pill);font-size:12.5px}
  .docs-nav-list a::before,.docs-nav-list a.sub::before{display:none}
  .docs-nav-list a.sub{padding-left:10px}
  .docs-nav-list a.on{border-color:var(--brand-soft2)}
  .docs-nav-foot{flex-direction:row;gap:14px;padding-left:2px}
}
@media (max-width:768px){
  .docs-main{font-size:14px}
  .docs-main h2{font-size:20px}
  .docs-main > section{margin-top:32px;padding-top:24px}
  .docs-main .page-head.lg{margin-bottom:8px}
  .docs-main .page-head.lg h1{font-size:28px}
  .docs-main .code pre,.docs-main .term{font-size:12.25px}
  .docs-main .code-lg pre{font-size:14px}
  .docs-ep{width:100%}
  .docs-ep .u{flex:1}
  .docs-main .table-wrap{border-radius:var(--r)}
  .docs-paths .card-pad,.docs-traffic .card-pad{padding:16px}
  .docs-end .btn{flex:1 1 auto}
}

/* -- 09 打印 ----------------------------------------------------------------- */
@media print{
  .docs-nav,.docs-end{display:none!important}
  .docs-layout{display:block}
  .docs-main{max-width:none}
  .docs-clients .tablist{display:none}
  .docs-clients .tabpanel[hidden]{display:block}
  .docs-panel-t{display:block}
  .docs-main .term{background:#f3f4f6!important;color:#000!important}
  .docs-main .term .a,.docs-main .term b,.docs-main .term .faint{color:#000!important}
  .docs-main > section{break-inside:auto}
  .docs-main .code,.docs-main .table-wrap{break-inside:avoid}
}