/* ===========================================================
   /docs — documentation site
   Article + sticky sidebar + client-side search.
   Matches tokens-v3 + legal.css aesthetic.
   =========================================================== */

.docs-shell {
  max-width: 1200px;
  margin: 0 auto;
  padding: 36px 24px 96px;
  display: grid;
  grid-template-columns: 240px 1fr;
  gap: 48px;
  align-items: start;
}

/* ---------- Hero (only on /docs landing) ---------- */
.docs-hero {
  max-width: 1200px;
  margin: 0 auto;
  padding: 48px 24px 8px;
}
.docs-hero__eyebrow {
  color: var(--bn-ink-muted);
  text-transform: uppercase;
  font-size: 12px;
  letter-spacing: 0.06em;
  font-weight: 500;
  margin: 0 0 12px;
}
.docs-hero__title {
  font-family: 'Geist', system-ui, sans-serif;
  font-size: 44px;
  font-weight: 510;
  letter-spacing: -0.04em;
  line-height: 1.1;
  margin: 0 0 12px;
  color: var(--bn-ink);
}
.docs-hero__lede {
  font-size: 17px;
  color: var(--bn-ink-secondary);
  line-height: 1.6;
  margin: 0 0 24px;
  max-width: 720px;
}

/* ---------- Search bar ---------- */
.docs-search {
  position: relative;
  max-width: 560px;
  margin: 0 0 16px;
}
.docs-search__input {
  width: 100%;
  height: 48px;
  background: var(--bn-bg-surface-1);
  border: 1px solid var(--bn-border);
  border-radius: 12px;
  padding: 0 16px 0 44px;
  font: inherit;
  font-size: 15px;
  color: var(--bn-ink);
  outline: none;
  transition: border-color 120ms ease, box-shadow 120ms ease;
}
.docs-search__input::placeholder { color: var(--bn-ink-muted); }
.docs-search__input:focus {
  border-color: var(--bn-accent);
  box-shadow: 0 0 0 4px var(--bn-accent-soft);
}
.docs-search__icon {
  position: absolute;
  left: 14px;
  top: 50%;
  transform: translateY(-50%);
  color: var(--bn-ink-muted);
  pointer-events: none;
  font-size: 18px;
}
.docs-search__hint {
  margin-top: 8px;
  font-size: 12px;
  color: var(--bn-ink-muted);
}
.docs-search__hint kbd {
  background: var(--bn-bg-surface-2);
  border: 1px solid var(--bn-border);
  border-radius: 4px;
  padding: 1px 6px;
  font-family: 'Geist Mono', monospace;
  font-size: 11px;
  color: var(--bn-ink-secondary);
}

/* ---------- Sidebar ---------- */
.docs-sidebar {
  position: sticky;
  top: 24px;
  align-self: start;
  font-size: 14px;
}
.docs-sidebar__section {
  margin-bottom: 22px;
}
.docs-sidebar__heading {
  color: var(--bn-ink-muted);
  text-transform: uppercase;
  font-size: 11px;
  letter-spacing: 0.08em;
  font-weight: 500;
  margin: 0 0 8px;
  padding-left: 10px;
}
.docs-sidebar__list {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-direction: column;
  gap: 1px;
}
.docs-sidebar__link {
  display: flex;
  align-items: center;
  gap: 8px;
  padding: 6px 10px;
  border-radius: 6px;
  color: var(--bn-ink-secondary);
  text-decoration: none;
  font-weight: 400;
  line-height: 1.4;
  transition: background 100ms ease, color 100ms ease;
}
.docs-sidebar__link:hover {
  background: var(--bn-bg-surface-1);
  color: var(--bn-ink);
}
.docs-sidebar__link.is-active {
  background: var(--bn-bg-surface-1);
  color: var(--bn-ink);
  font-weight: 510;
  box-shadow: inset 2px 0 0 var(--bn-accent);
}
.docs-sidebar__link iconify-icon {
  flex-shrink: 0;
  font-size: 14px;
  color: var(--bn-ink-muted);
}
.docs-sidebar__link.is-active iconify-icon { color: var(--bn-accent); }

/* Mobile dropdown */
.docs-mobile-nav {
  display: none;
  margin-bottom: 18px;
}
.docs-mobile-nav__select {
  width: 100%;
  height: 44px;
  border: 1px solid var(--bn-border);
  background: var(--bn-bg-surface-1);
  border-radius: 10px;
  padding: 0 12px;
  color: var(--bn-ink);
  font: inherit;
  font-size: 14px;
}

/* ---------- Article ---------- */
.docs-article {
  max-width: 780px;
  min-width: 0;
}
.docs-article__crumbs {
  font-size: 13px;
  color: var(--bn-ink-muted);
  margin: 0 0 18px;
  display: flex;
  align-items: center;
  gap: 6px;
  flex-wrap: wrap;
}
.docs-article__crumbs a {
  color: var(--bn-ink-muted);
  text-decoration: none;
}
.docs-article__crumbs a:hover { color: var(--bn-accent); }
.docs-article__crumbs__sep { opacity: 0.5; }

.docs-h1 {
  font-family: 'Geist', system-ui, sans-serif;
  font-size: 36px;
  font-weight: 510;
  letter-spacing: -0.035em;
  line-height: 1.1;
  margin: 0 0 12px;
  color: var(--bn-ink);
}
.docs-lede {
  font-size: 16px;
  color: var(--bn-ink-secondary);
  line-height: 1.65;
  margin: 0 0 28px;
  max-width: 720px;
}

.docs-h2 {
  font-size: 22px;
  font-weight: 510;
  letter-spacing: -0.025em;
  margin: 40px 0 12px;
  color: var(--bn-ink);
}
.docs-h3 {
  font-size: 17px;
  font-weight: 510;
  letter-spacing: -0.015em;
  margin: 28px 0 10px;
  color: var(--bn-ink);
}
.docs-p,
.docs-ul li,
.docs-ol li {
  color: var(--bn-ink-secondary);
  line-height: 1.7;
  font-size: 15px;
}
.docs-p { margin: 0 0 14px; }
.docs-ul,
.docs-ol {
  padding-left: 22px;
  margin: 0 0 18px;
}
.docs-ul li,
.docs-ol li { padding: 4px 0; }

.docs-article a:not(.bn-btn):not(.docs-card):not(.docs-sidebar__link) {
  color: var(--bn-accent);
  text-decoration: none;
}
.docs-article a:not(.bn-btn):not(.docs-card):not(.docs-sidebar__link):hover {
  text-decoration: underline;
}

/* Inline code */
.docs-article code,
.legal-shell code {
  background: var(--bn-bg-surface-2);
  padding: 2px 6px;
  border-radius: 4px;
  font-size: 13px;
  color: var(--bn-ink);
  font-family: 'Geist Mono', monospace;
}

/* Code blocks */
.docs-article pre {
  background: var(--bn-bg-inverse);
  color: var(--bn-ink-inverse);
  border-radius: 12px;
  padding: 16px 18px;
  overflow-x: auto;
  margin: 12px 0 20px;
  font-family: 'Geist Mono', monospace;
  font-size: 13px;
  line-height: 1.55;
  border: 1px solid rgba(255,255,255,0.06);
}
.docs-article pre code {
  background: transparent;
  padding: 0;
  color: inherit;
  font-size: inherit;
  border-radius: 0;
}

/* Card list for landing / skill list */
.docs-cards {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 14px;
  margin: 0 0 24px;
}
.docs-card {
  background: var(--bn-bg-surface-1);
  border: 1px solid var(--bn-border-soft);
  border-radius: 14px;
  padding: 18px 20px;
  text-decoration: none;
  color: inherit;
  display: flex;
  flex-direction: column;
  gap: 6px;
  transition: border-color 120ms ease, transform 120ms ease, background 120ms ease;
}
.docs-card:hover {
  border-color: var(--bn-border-strong);
  transform: translateY(-1px);
  background: var(--bn-bg-surface-1);
}
.docs-card__head {
  display: flex;
  align-items: center;
  gap: 8px;
  font-size: 15px;
  font-weight: 510;
  color: var(--bn-ink);
}
.docs-card__head iconify-icon {
  font-size: 18px;
  color: var(--bn-accent);
}
.docs-card__desc {
  color: var(--bn-ink-secondary);
  font-size: 13px;
  line-height: 1.5;
  margin: 0;
}
.docs-card__chip {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  align-self: flex-start;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  background: var(--bn-accent-soft);
  color: var(--bn-accent-bright);  /* AA contrast on tinted dark bg */
  padding: 3px 8px;
  border-radius: 999px;
  font-weight: 510;
}

/* Info / callout cards inside articles */
.docs-callout {
  background: var(--bn-bg-surface-1);
  border: 1px solid var(--bn-border-soft);
  border-left: 3px solid var(--bn-accent);
  border-radius: 12px;
  padding: 14px 18px;
  margin: 16px 0 20px;
  font-size: 14px;
  color: var(--bn-ink-secondary);
  line-height: 1.6;
}
.docs-callout strong { color: var(--bn-ink); }
.docs-callout--warn { border-left-color: var(--bn-warning); }
.docs-callout--danger { border-left-color: var(--bn-danger); }
.docs-callout--success { border-left-color: var(--bn-success); }

/* TODO/Edit-on-GitHub chip */
.docs-todo {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  background: var(--bn-bg-surface-2);
  color: var(--bn-ink-muted);
  padding: 3px 8px;
  border-radius: 999px;
  font-weight: 510;
}

.docs-edit {
  margin-top: 48px;
  padding-top: 16px;
  border-top: 1px solid var(--bn-border-soft);
  font-size: 13px;
  color: var(--bn-ink-muted);
  display: flex;
  justify-content: space-between;
  align-items: center;
  gap: 12px;
  flex-wrap: wrap;
}
.docs-edit a {
  color: var(--bn-ink-muted);
  text-decoration: none;
  display: inline-flex;
  align-items: center;
  gap: 6px;
}
.docs-edit a:hover { color: var(--bn-accent); }

/* API endpoint block */
.docs-endpoint {
  display: flex;
  align-items: center;
  gap: 8px;
  margin: 22px 0 8px;
  flex-wrap: wrap;
}
.docs-endpoint__method {
  font-family: 'Geist Mono', monospace;
  font-size: 12px;
  font-weight: 600;
  padding: 3px 8px;
  border-radius: 6px;
  color: white;
  background: var(--bn-info);
}
.docs-endpoint__method--get  { background: #2D6E9D; }
.docs-endpoint__method--post { background: #4A7C59; }
.docs-endpoint__method--del  { background: #C5392A; }
.docs-endpoint__path {
  font-family: 'Geist Mono', monospace;
  font-size: 14px;
  color: var(--bn-ink);
}

/* Skill row (skills.html list) */
.docs-skill {
  background: var(--bn-bg-surface-1);
  border: 1px solid var(--bn-border-soft);
  border-radius: 14px;
  padding: 18px 20px;
  margin: 0 0 12px;
  display: grid;
  grid-template-columns: 36px 1fr auto;
  gap: 14px;
  align-items: start;
}
.docs-skill__icon {
  width: 36px;
  height: 36px;
  border-radius: 10px;
  background: var(--bn-accent-soft);
  color: var(--bn-accent);
  display: grid;
  place-items: center;
  font-size: 18px;
}
.docs-skill__body { min-width: 0; }
.docs-skill__name {
  font-size: 15px;
  font-weight: 510;
  color: var(--bn-ink);
  margin: 0 0 4px;
  display: flex;
  align-items: center;
  gap: 8px;
  flex-wrap: wrap;
}
.docs-skill__name a {
  color: var(--bn-ink);
  text-decoration: none;
}
.docs-skill__name a:hover { color: var(--bn-accent); }
.docs-skill__desc {
  color: var(--bn-ink-secondary);
  font-size: 14px;
  line-height: 1.55;
  margin: 0 0 10px;
}
.docs-skill__example {
  font-family: 'Geist Mono', monospace;
  font-size: 12px;
  background: var(--bn-bg-page);
  border: 1px solid var(--bn-border-soft);
  border-radius: 8px;
  padding: 8px 10px;
  color: var(--bn-ink-secondary);
  display: block;
  margin-bottom: 8px;
}
.docs-skill__envs {
  font-family: 'Geist Mono', monospace;
  font-size: 11px;
  color: var(--bn-ink-muted);
}
.docs-skill__chip {
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  background: var(--bn-bg-surface-2);
  color: var(--bn-ink-muted);
  padding: 2px 7px;
  border-radius: 999px;
  font-weight: 510;
}
.docs-skill__chip--new {
  background: var(--bn-accent-soft);
  color: var(--bn-accent);
}

/* Skill row when hidden by search */
.docs-card.is-hidden,
.docs-skill.is-hidden { display: none; }

.docs-empty {
  display: none;
  color: var(--bn-ink-muted);
  font-size: 14px;
  padding: 18px 20px;
  border: 1px dashed var(--bn-border);
  border-radius: 12px;
  text-align: center;
}
.docs-empty.is-on { display: block; }

/* ---------- Dark theme overrides ---------- */
[data-theme="dark"] .docs-card,
[data-theme="dark"] .docs-skill,
[data-theme="dark"] .docs-callout {
  background: var(--bn-bg-surface-1);
  border-color: var(--bn-border);
}
[data-theme="dark"] .docs-search__input {
  background: var(--bn-bg-surface-1);
  border-color: var(--bn-border);
}
[data-theme="dark"] .docs-skill__example {
  background: var(--bn-bg-page);
  border-color: var(--bn-border);
}
[data-theme="dark"] .docs-article pre {
  background: #08070A;
}

/* ---------- Mobile ---------- */
@media (max-width: 900px) {
  .docs-shell {
    grid-template-columns: 1fr;
    gap: 0;
    padding: 24px 16px 60px;
  }
  .docs-sidebar { display: none; }
  .docs-mobile-nav { display: block; }
  .docs-hero { padding: 28px 16px 4px; }
  .docs-hero__title { font-size: 32px; letter-spacing: -0.03em; }
  .docs-cards { grid-template-columns: 1fr; }
  .docs-h1 { font-size: 28px; }
  .docs-skill {
    grid-template-columns: 32px 1fr;
    gap: 12px;
    padding: 16px;
  }
  .docs-skill__icon { width: 32px; height: 32px; font-size: 16px; }
}