/* Human documentation surface. Raw Markdown/JSON/OpenAPI remain the machine contract. */

.docs-app {
  min-height: 100vh;
  background: var(--bg-canvas);
}

.docs-topbar {
  position: sticky;
  z-index: 30;
  top: 0;
  border-bottom: 1px solid var(--border-default);
  background: color-mix(in srgb, var(--bg-canvas) 94%, transparent);
  backdrop-filter: blur(14px);
}

.docs-topbar-inner {
  width: min(100%, 1440px);
  min-height: 64px;
  margin-inline: auto;
  padding-inline: clamp(18px, 3vw, 36px);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 24px;
}

.docs-topbar nav,
.docs-topbar-actions {
  display: flex;
  align-items: center;
  gap: 16px;
}

.docs-topbar a:not(.wordmark):not(.button) {
  color: var(--text-secondary);
  text-decoration: none;
  font-size: 13px;
}

.docs-shell {
  width: min(100%, 1440px);
  margin-inline: auto;
  display: grid;
  grid-template-columns: 230px minmax(0, 1fr);
  min-height: calc(100vh - 64px);
}

.docs-sidebar {
  position: sticky;
  top: 64px;
  align-self: start;
  height: calc(100vh - 64px);
  overflow: auto;
  border-right: 1px solid var(--border-default);
  padding: 34px 24px 48px clamp(18px, 3vw, 36px);
}

.docs-sidebar p {
  margin: 0 0 10px;
  color: var(--text-tertiary);
  font: 650 10px/1.2 var(--font-mono);
  letter-spacing: 0.1em;
  text-transform: uppercase;
}

.docs-sidebar nav {
  display: grid;
  gap: 3px;
}

.docs-sidebar a {
  border-radius: 7px;
  padding: 8px 10px;
  color: var(--text-secondary);
  text-decoration: none;
  font-size: 13px;
}

.docs-sidebar a:hover,
.docs-sidebar a[aria-current="page"] {
  background: var(--bg-subtle);
  color: var(--text-primary);
}

.docs-sidebar-group + .docs-sidebar-group {
  margin-top: 26px;
}

.docs-main {
  min-width: 0;
  padding: clamp(44px, 6vw, 80px) clamp(24px, 6vw, 88px) 96px;
}

.docs-content {
  width: min(100%, 920px);
}

.docs-content > .eyebrow + h1 {
  max-width: 820px;
  margin: 12px 0 0;
  font-size: clamp(42px, 6vw, 68px);
  line-height: 0.98;
  letter-spacing: -0.045em;
}

.docs-lead {
  max-width: 740px;
  margin: 24px 0 0;
  color: var(--text-secondary);
  font-size: 18px;
  line-height: 1.65;
}

.docs-section {
  scroll-margin-top: 94px;
  margin-top: clamp(60px, 8vw, 92px);
  padding-top: 8px;
}

.docs-section + .docs-section {
  border-top: 1px solid var(--border-default);
  padding-top: clamp(54px, 7vw, 76px);
}

.docs-section h2 {
  max-width: 760px;
  margin: 0 0 18px;
  font-size: clamp(28px, 4vw, 40px);
  line-height: 1.06;
  letter-spacing: -0.035em;
}

.docs-section h3 {
  margin: 34px 0 10px;
  font-size: 19px;
}

.docs-section p,
.docs-section li {
  max-width: 760px;
  color: var(--text-secondary);
  font-size: 15px;
  line-height: 1.7;
}

.docs-section li + li {
  margin-top: 7px;
}

.docs-section code:not(pre code) {
  border: 1px solid var(--border-default);
  border-radius: 5px;
  padding: 2px 5px;
  background: var(--bg-elevated);
  color: var(--text-primary);
  font-size: 0.88em;
}

.docs-code {
  position: relative;
  overflow: auto;
  margin: 20px 0;
  border: 1px solid var(--border-default);
  border-radius: 12px;
  padding: 18px;
  background: var(--bg-inverse);
  color: var(--text-inverse);
  font: 500 12.5px/1.65 var(--font-mono);
}

.docs-table-wrap {
  overflow-x: auto;
  margin: 20px 0;
  border: 1px solid var(--border-default);
  border-radius: 12px;
}

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

.docs-table th,
.docs-table td {
  padding: 11px 13px;
  border-bottom: 1px solid var(--border-default);
  vertical-align: top;
  text-align: left;
}

.docs-table th {
  background: var(--bg-subtle);
  color: var(--text-secondary);
  font: 650 10.5px/1.3 var(--font-mono);
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

.docs-table tr:last-child td {
  border-bottom: 0;
}

.docs-callout {
  margin: 22px 0;
  border: 1px solid var(--border-default);
  border-left: 3px solid var(--brand);
  border-radius: 10px;
  padding: 15px 17px;
  background: var(--bg-elevated);
}

.docs-callout[data-kind="warning"] {
  border-left-color: var(--warning);
  background: var(--warning-soft);
}

.docs-callout[data-kind="success"] {
  border-left-color: var(--success);
  background: var(--success-soft);
}

.docs-callout strong {
  display: block;
  margin-bottom: 5px;
  font-size: 13px;
}

.docs-callout p {
  margin: 0;
  font-size: 13px;
}

.docs-runtime {
  display: grid;
  grid-template-columns: repeat(3, minmax(0, 1fr));
  gap: 1px;
  overflow: hidden;
  margin: 30px 0 0;
  border: 1px solid var(--border-default);
  border-radius: 12px;
  background: var(--border-default);
}

.docs-runtime > div {
  min-width: 0;
  padding: 14px;
  background: var(--bg-surface);
}

.docs-runtime span {
  display: block;
  color: var(--text-tertiary);
  font: 620 10px/1.2 var(--font-mono);
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.docs-runtime strong {
  display: block;
  margin-top: 7px;
  overflow-wrap: anywhere;
  font-size: 13px;
}

.docs-tools {
  display: grid;
  grid-template-columns: repeat(2, minmax(0, 1fr));
  gap: 10px;
  margin-top: 28px;
}

.docs-tool {
  border: 1px solid var(--border-default);
  border-radius: 12px;
  padding: 17px;
  background: var(--bg-surface);
  color: inherit;
  text-decoration: none;
}

.docs-tool:hover {
  border-color: var(--border-strong);
  background: var(--bg-elevated);
}

.docs-tool strong {
  display: block;
  font-size: 14px;
}

.docs-tool span {
  display: block;
  margin-top: 6px;
  color: var(--text-secondary);
  font-size: 12.5px;
  line-height: 1.5;
}

/* Operations reference */

.operations-toolbar {
  position: sticky;
  z-index: 10;
  top: 64px;
  display: grid;
  grid-template-columns: minmax(230px, 1fr) 170px 170px;
  gap: 8px;
  margin: 32px 0 18px;
  border-block: 1px solid var(--border-default);
  padding: 12px 0;
  background: var(--bg-canvas);
}

.operations-toolbar label {
  margin: 0;
}

.operations-grid {
  display: grid;
  gap: 9px;
}

.operation-card {
  scroll-margin-top: 140px;
  border: 1px solid var(--border-default);
  border-radius: 12px;
  padding: 17px 18px;
  background: var(--bg-surface);
}

.operation-card-head {
  display: flex;
  align-items: flex-start;
  justify-content: space-between;
  gap: 18px;
}

.operation-card h2 {
  margin: 0;
  font: 650 15px/1.35 var(--font-mono);
  letter-spacing: -0.01em;
}

.operation-card p {
  max-width: 720px;
  margin: 9px 0 0;
  color: var(--text-secondary);
  font-size: 13px;
  line-height: 1.6;
}

.operation-meta {
  display: flex;
  flex-wrap: wrap;
  gap: 5px;
}

.operation-card details {
  margin-top: 14px;
  border-top: 1px solid var(--border-default);
  padding-top: 12px;
}

.operation-card pre {
  overflow: auto;
  margin: 11px 0 0;
  border-radius: 9px;
  padding: 13px;
  background: var(--bg-inverse);
  color: var(--text-inverse);
  font-size: 11.5px;
}

.docs-empty {
  border: 1px dashed var(--border-default);
  border-radius: 12px;
  padding: 24px;
  color: var(--text-secondary);
}

.docs-mobile-menu {
  display: none;
}

@media (max-width: 900px) {
  .docs-shell {
    grid-template-columns: 1fr;
  }

  .docs-sidebar {
    display: none;
  }

  .docs-main {
    padding-inline: clamp(18px, 5vw, 32px);
  }

  .docs-mobile-menu {
    display: block;
  }

  .docs-mobile-menu summary {
    cursor: pointer;
    border: 1px solid var(--border-default);
    border-radius: 8px;
    padding: 8px 10px;
    font-size: 13px;
  }

  .docs-mobile-menu nav {
    position: absolute;
    right: 18px;
    top: 54px;
    display: grid;
    min-width: 220px;
    border: 1px solid var(--border-default);
    border-radius: 10px;
    padding: 7px;
    background: var(--bg-surface);
    box-shadow: var(--shadow-float);
  }

  .docs-mobile-menu nav a {
    border-radius: 6px;
    padding: 9px 10px;
    text-decoration: none;
  }

  .operations-toolbar {
    top: 64px;
    grid-template-columns: 1fr;
  }
}

@media (max-width: 640px) {
  .docs-topbar nav {
    display: none;
  }

  .docs-runtime,
  .docs-tools {
    grid-template-columns: 1fr;
  }

  .operation-card-head {
    flex-direction: column;
  }
}