/* hwclaw API 文档页外壳样式。
   token 与 admin/src/styles.css 对齐，视觉上保持与后台一致的扁平风格。
   刻意不复用 Swagger UI 的样式变量：5.x 是编译好的 CSS，几乎不暴露自定义属性，
   覆盖类名很脆弱且升级必碎——这里只对它做文末标注的三处最小覆盖。 */

:root {
  --brand: #de4d2b;
  --brand-weak: rgba(222, 77, 43, .10);
  --shell: #20242b;
  --ink: #1f2328;
  --ink-2: #57606a;
  --ink-3: #8b949e;
  --bg: #f6f7f9;
  --surface: #ffffff;
  --border: #e5e7eb;
  --up: #2f6feb;
  --down: #1a7f5a;
  --bin: #8250df;
  --radius: 8px;
  --font: -apple-system, BlinkMacSystemFont, "Segoe UI", "PingFang SC", "Hiragino Sans GB", "Microsoft YaHei", sans-serif;
  --mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, monospace;
}

* ,
*::before,
*::after {
  box-sizing: border-box;
}

html {
  background: var(--bg);
}

body {
  margin: 0;
  min-width: 320px;
  color: var(--ink);
  background: var(--bg);
  font-family: var(--font);
  font-size: 14px;
  line-height: 1.7;
  -webkit-font-smoothing: antialiased;
  overflow-x: hidden;
}

code, pre {
  font-family: var(--mono);
}

/* ---------- 顶栏 ---------- */

.site-header {
  background: var(--shell);
  padding: 0 24px;
}

.site-header-inner {
  max-width: 1180px;
  margin: 0 auto;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 16px;
  padding: 18px 0;
  flex-wrap: wrap;
}

.site-brand {
  display: flex;
  align-items: center;
  gap: 12px;
  min-width: 0;
}

.site-brand-mark {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 34px;
  height: 34px;
  border-radius: var(--radius);
  background: var(--brand);
  color: #fff;
  font-weight: 800;
  font-size: 13px;
  flex: none;
}

.site-brand-text {
  display: flex;
  flex-direction: column;
  min-width: 0;
}

.site-name {
  color: #fff;
  font-size: 16px;
  font-weight: 700;
  line-height: 1.3;
}

.site-title {
  color: rgba(255, 255, 255, .68);
  font-size: 12px;
  line-height: 1.4;
}

.site-header-meta {
  display: flex;
  align-items: center;
  gap: 8px;
  flex-wrap: wrap;
}

.version-badge {
  display: inline-flex;
  align-items: center;
  padding: 4px 10px;
  border-radius: 999px;
  background: rgba(255, 255, 255, .10);
  color: #fff;
  font-size: 12px;
  font-family: var(--mono);
  white-space: nowrap;
}

.contract-links {
  max-width: 1180px;
  margin: 0 auto;
  padding: 10px 0 16px;
  display: flex;
  align-items: center;
  gap: 12px;
  flex-wrap: wrap;
  border-top: 1px solid rgba(255, 255, 255, .08);
}

.contract-links-label {
  color: rgba(255, 255, 255, .56);
  font-size: 12px;
}

.contract-link {
  color: rgba(255, 255, 255, .82);
  font-size: 12px;
  font-family: var(--mono);
  text-decoration: none;
  border-bottom: 1px dashed rgba(255, 255, 255, .32);
}

.contract-link:hover {
  color: #fff;
  border-bottom-color: #fff;
}

/* ---------- 接入导航 ---------- */

.onboarding {
  max-width: 1180px;
  margin: 0 auto;
  padding: 24px 24px 0;
}

.onboarding-heading {
  margin: 0 0 12px;
  font-size: 13px;
  font-weight: 700;
  color: var(--ink-2);
  text-transform: uppercase;
  letter-spacing: .04em;
}

.onboarding-grid {
  margin: 0;
  padding: 0;
  list-style: none;
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  gap: 12px;
}

.onboarding-card {
  width: 100%;
  height: 100%;
  display: block;
  text-align: left;
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 16px;
  cursor: pointer;
  font: inherit;
  color: inherit;
  transition: border-color .12s ease, box-shadow .12s ease;
}

.onboarding-card:hover {
  border-color: var(--brand);
}

.onboarding-card:focus-visible {
  outline: 2px solid var(--brand);
  outline-offset: 2px;
}

.onboarding-step {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 24px;
  height: 24px;
  border-radius: 999px;
  background: var(--brand-weak);
  color: var(--brand);
  font-weight: 700;
  font-size: 12px;
  margin-bottom: 10px;
}

.onboarding-title {
  margin: 0 0 6px;
  font-size: 14px;
  font-weight: 700;
  color: var(--ink);
}

.onboarding-endpoint {
  margin: 0 0 6px;
  font-size: 12px;
  color: var(--ink-2);
}

.onboarding-endpoint code {
  color: var(--ink);
}

.onboarding-desc {
  margin: 0;
  font-size: 12.5px;
  color: var(--ink-2);
  line-height: 1.6;
}

.onboarding-desc code {
  color: var(--ink);
  background: var(--bg);
  border-radius: 4px;
  padding: 1px 4px;
}

/* ---------- tab 切换 ---------- */

.doc-tabs {
  max-width: 1180px;
  margin: 20px auto 0;
  padding: 0 24px;
  display: flex;
  gap: 4px;
  border-bottom: 1px solid var(--border);
}

.doc-tab {
  appearance: none;
  border: none;
  background: transparent;
  font: inherit;
  font-weight: 600;
  font-size: 13.5px;
  color: var(--ink-2);
  padding: 10px 16px;
  border-bottom: 2px solid transparent;
  margin-bottom: -1px;
  cursor: pointer;
}

.doc-tab:hover {
  color: var(--ink);
}

.doc-tab.is-active {
  color: var(--brand);
  border-bottom-color: var(--brand);
}

.doc-main {
  max-width: 1180px;
  margin: 0 auto;
  padding: 0 24px 32px;
}

.doc-panel[hidden] {
  display: none;
}

/* ---------- Swagger UI 最小覆盖（仅这三条） ---------- */

.swagger-ui .topbar { display: none; }
.swagger-ui .information-container { display: none; }
.swagger-ui .wrapper { max-width: 1180px; }

#swagger-ui {
  margin-top: 16px;
}

/* ---------- WebSocket 面板 ---------- */

.ws-layout {
  display: grid;
  grid-template-columns: 200px 1fr;
  gap: 24px;
  align-items: start;
  margin-top: 16px;
}

.ws-toc {
  position: sticky;
  top: 16px;
}

.ws-toc-inner {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 14px;
}

.ws-toc-heading {
  margin: 0 0 8px;
  font-size: 12px;
  font-weight: 700;
  color: var(--ink-3);
  text-transform: uppercase;
  letter-spacing: .04em;
}

.ws-toc-list {
  margin: 0;
  padding: 0;
  list-style: none;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.ws-toc-link {
  display: block;
  width: 100%;
  text-align: left;
  appearance: none;
  border: none;
  background: transparent;
  font: inherit;
  font-size: 12.5px;
  color: var(--ink-2);
  padding: 6px 8px;
  border-radius: 6px;
  cursor: pointer;
}

.ws-toc-link:hover {
  background: var(--bg);
  color: var(--ink);
}

.ws-content {
  min-width: 0;
}

.ws-loading,
.ws-error {
  color: var(--ink-2);
}

.ws-error {
  color: var(--brand);
}

.ws-header {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 20px;
  margin-bottom: 20px;
}

.ws-title {
  margin: 0 0 6px;
  font-size: 20px;
}

.ws-meta {
  margin: 0 0 12px;
  color: var(--ink-2);
  font-size: 12.5px;
  font-family: var(--mono);
}

.ws-desc {
  margin: 0 0 16px;
  white-space: pre-wrap;
  color: var(--ink-2);
}

.ws-section {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 20px;
  margin-bottom: 20px;
}

.ws-section-title {
  margin: 0 0 12px;
  font-size: 16px;
}

.ws-section-sub {
  margin: 16px 0 8px;
  font-size: 13px;
  color: var(--ink-2);
}

.ws-section-sub:first-of-type {
  margin-top: 0;
}

.ws-channel {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius);
  padding: 20px;
  margin-bottom: 20px;
}

.channel-path {
  margin: 0 0 8px;
  font-family: var(--mono);
  font-size: 17px;
  font-weight: 700;
}

.channel-desc {
  margin: 0 0 16px;
  white-space: pre-wrap;
  color: var(--ink-2);
}

.channel-sub-heading {
  margin: 16px 0 8px;
  font-size: 13px;
  color: var(--ink-2);
}

/* ---------- 消息分组 / 卡片 ---------- */

.msg-group {
  margin-top: 18px;
  padding-top: 14px;
  border-top: 1px solid var(--border);
}

.msg-group-heading {
  margin: 0 0 12px;
  font-size: 13.5px;
  display: flex;
  align-items: baseline;
  gap: 6px;
}

.msg-group--up .msg-group-heading { color: var(--up); }
.msg-group--down .msg-group-heading { color: var(--down); }

.msg-group-summary {
  color: var(--ink-2);
  font-weight: 400;
  font-size: 12.5px;
}

.msg-grid {
  display: grid;
  /* min(320px, 100%) 而不是裸 320px：否则窄屏下 grid track 的自动最小宽度会按
     320px 硬算，即使只有一列也会把 msg-card 撑出容器。 */
  grid-template-columns: repeat(auto-fill, minmax(min(320px, 100%), 1fr));
  gap: 12px;
}

.msg-card {
  /* grid item 默认的自动最小宽度是内容的 min-content：卡片里表头用了
     white-space: nowrap，min-content 会很宽，不清零这里整张卡会把 msg-grid
     撑爆，即使表格自己包了 overflow-x:auto 也没用（那只管表格内部横向滚动，
     不改变外层卡片对 grid track 的最小宽度诉求）。 */
  min-width: 0;
  border: 1px solid var(--border);
  border-left-width: 3px;
  border-radius: var(--radius);
  padding: 14px;
  background: var(--bg);
}

.msg-card--up { border-left-color: var(--up); }
.msg-card--down { border-left-color: var(--down); }

.msg-card-head {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 8px;
  margin-bottom: 6px;
}

.msg-type {
  font-size: 13.5px;
  font-weight: 700;
  color: var(--ink);
}

.msg-key {
  font-size: 11px;
  color: var(--ink-3);
}

.msg-binary-badge {
  display: inline-flex;
  align-items: center;
  padding: 2px 8px;
  border-radius: 999px;
  background: rgba(130, 80, 223, .12);
  color: var(--bin);
  font-size: 11px;
  font-weight: 600;
}

.msg-title {
  margin: 0 0 4px;
  font-size: 12.5px;
  color: var(--ink-2);
  font-weight: 600;
}

.msg-summary {
  margin: 0 0 10px;
  color: var(--ink-2);
  font-size: 12.5px;
}

.msg-binary-desc {
  margin: 0;
  white-space: pre-wrap;
  color: var(--ink-2);
  font-size: 12.5px;
}

/* ---------- 表格 ---------- */

.table-scroll {
  overflow-x: auto;
  max-width: 100%;
}

.data-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13px;
}

.data-table caption {
  text-align: left;
  font-size: 12.5px;
  font-weight: 700;
  color: var(--ink-2);
  padding-bottom: 6px;
}

.data-table th,
.data-table td {
  text-align: left;
  padding: 6px 10px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
  white-space: pre-wrap;
}

.data-table th {
  color: var(--ink-3);
  font-weight: 600;
  font-size: 12px;
  white-space: nowrap;
}

.data-table code {
  font-size: 12px;
}

.field-desc {
  margin: 0;
  white-space: pre-wrap;
}

.field-nested {
  margin-top: 6px;
}

.field-nested > summary {
  cursor: pointer;
  font-size: 12px;
  color: var(--brand);
}

.field-nested .table-scroll {
  margin-top: 8px;
}

/* ---------- 页脚 ---------- */

.site-footer {
  max-width: 1180px;
  margin: 0 auto;
  padding: 16px 24px 32px;
  color: var(--ink-3);
  font-size: 12px;
}

.site-footer p {
  margin: 0;
}

/* ---------- 响应式 ---------- */

@media (max-width: 900px) {
  .onboarding-grid {
    grid-template-columns: repeat(2, 1fr);
  }

  .ws-layout {
    grid-template-columns: 1fr;
  }

  .ws-toc {
    position: static;
  }
}

@media (max-width: 520px) {
  .onboarding-grid {
    grid-template-columns: 1fr;
  }

  .site-header {
    padding: 0 16px;
  }

  .onboarding,
  .doc-tabs,
  .doc-main,
  .site-footer {
    padding-left: 16px;
    padding-right: 16px;
  }

  .msg-grid {
    grid-template-columns: 1fr;
  }
}