/* ------------------------------------------------------------------ *
 * @zero-bot.net/tg-bot-api — documentation
 *
 * Dark-first. Every colour is a semantic token; components never name a
 * colour. Light is a first-class second theme, not an inversion.
 * ------------------------------------------------------------------ */

/* ------------------------------------------------------------------ *
 * Tokens
 * ------------------------------------------------------------------ */

:root {
  color-scheme: dark;

  /* Surfaces — elevation comes from lightness + borders, not shadows */
  --bg-base: #0b0d10;
  --surface: #131720;
  --surface-raised: #191e28;
  --surface-overlay: #212734;
  --surface-sunken: #080a0d;

  --border-subtle: #232a36;
  --border-strong: #6d7891;

  --text-primary: #e6e9ef;
  --text-secondary: #9aa3b2;
  --text-muted: #8b93a0;
  --text-inverse: #08131c;

  /* One accent, chosen cool + restrained for a developer tool */
  --accent: #4a9edb;
  --accent-hover: #67b1e6;
  --accent-subtle: #12293d;
  --accent-border: #2b5a7d;

  --success: #3fb950;
  --success-subtle: #0d2818;
  --warning: #d29922;
  --warning-subtle: #2b2111;
  --danger: #f26d6d;
  --danger-subtle: #2d1618;

  --focus-ring: #67b1e6;
  --edge-light: rgba(255, 255, 255, 0.07);

  --shadow-sm: none;
  --shadow-md: 0 4px 16px rgb(0 0 0 / 0.4);
  --shadow-lg: 0 12px 32px rgb(0 0 0 / 0.55);

  /* Code token colours — desaturated for dark ground */
  --code-comment: #6b7688;
  --code-string: #8fbf7f;
  --code-keyword: #c398e0;
  --code-number: #d0a86e;
  --code-func: #6fb4e6;

  /* Space */
  --sp-1: 2px;  --sp-2: 4px;  --sp-3: 6px;  --sp-4: 8px;
  --sp-5: 12px; --sp-6: 16px; --sp-7: 20px; --sp-8: 24px;
  --sp-9: 32px; --sp-10: 40px; --sp-11: 48px; --sp-12: 64px;

  /* Radius */
  --radius-sm: 4px;
  --radius-md: 8px;
  --radius-lg: 12px;
  --radius-pill: 9999px;

  /* Type */
  --font-sans: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;
  --font-mono: ui-monospace, SFMono-Regular, "SF Mono", Menlo, Consolas, "Liberation Mono", monospace;

  /* Motion */
  --duration-fast: 120ms;
  --duration-base: 180ms;
  --ease-out: cubic-bezier(0.16, 1, 0.3, 1);

  --sidebar-w: 264px;
  --topbar-h: 56px;
}

:root[data-theme="light"] {
  color-scheme: light;

  --bg-base: #f7f8fa;
  --surface: #ffffff;
  --surface-raised: #ffffff;
  --surface-overlay: #ffffff;
  --surface-sunken: #f0f2f5;

  --border-subtle: #e4e7ec;
  --border-strong: #7e8692;

  --text-primary: #14171c;
  --text-secondary: #565e6b;
  --text-muted: #5f6672;
  --text-inverse: #ffffff;

  --accent: #16679f;
  --accent-hover: #0f5586;
  --accent-subtle: #e8f2f9;
  --accent-border: #a8cbe3;

  --success: #1a7f37;
  --success-subtle: #e8f5ec;
  --warning: #8a5c00;
  --warning-subtle: #fdf3d9;
  --danger: #cf222e;
  --danger-subtle: #fdeceb;

  --focus-ring: #16679f;
  --edge-light: rgba(255, 255, 255, 0.9);

  --shadow-sm: 0 1px 2px rgb(16 24 40 / 0.06);
  --shadow-md: 0 4px 12px rgb(16 24 40 / 0.10);
  --shadow-lg: 0 12px 28px rgb(16 24 40 / 0.14);

  --code-comment: #6a737d;
  --code-string: #0a6640;
  --code-keyword: #7b2fa0;
  --code-number: #8a5a00;
  --code-func: #0f5586;
}

/* ------------------------------------------------------------------ *
 * Base
 * ------------------------------------------------------------------ */

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

html { -webkit-text-size-adjust: 100%; }

body {
  margin: 0;
  background: var(--bg-base);
  color: var(--text-primary);
  font-family: var(--font-sans);
  font-size: 14px;
  line-height: 1.5;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}

a { color: var(--accent); text-decoration: none; }
a:hover { color: var(--accent-hover); text-decoration: underline; text-underline-offset: 2px; }

h1, h2, h3, h4 { line-height: 1.25; letter-spacing: -0.01em; margin: 0; font-weight: 600; }

button { font: inherit; color: inherit; }

::selection { background: var(--accent-subtle); }

:focus-visible {
  outline: 2px solid var(--focus-ring);
  outline-offset: 2px;
  border-radius: var(--radius-sm);
}

/* Scrollbars match the theme instead of defaulting to the OS light ones */
* { scrollbar-color: var(--border-strong) transparent; scrollbar-width: thin; }
::-webkit-scrollbar { width: 10px; height: 10px; }
::-webkit-scrollbar-thumb { background: var(--border-subtle); border-radius: var(--radius-pill); border: 3px solid var(--bg-base); }
::-webkit-scrollbar-thumb:hover { background: var(--border-strong); }

.skip-link {
  position: absolute;
  left: var(--sp-6);
  top: -48px;
  z-index: 100;
  padding: var(--sp-3) var(--sp-5);
  background: var(--surface-overlay);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-sm);
  transition: top var(--duration-fast) var(--ease-out);
}
.skip-link:focus { top: var(--sp-6); }

/* ------------------------------------------------------------------ *
 * Shell
 * ------------------------------------------------------------------ */

.app { display: grid; grid-template-columns: var(--sidebar-w) minmax(0, 1fr); min-height: 100vh; }

.sidebar {
  position: sticky;
  top: 0;
  align-self: start;
  height: 100vh;
  overflow-y: auto;
  background: var(--surface-sunken);
  border-right: 1px solid var(--border-subtle);
  padding: var(--sp-6) var(--sp-5);
  display: flex;
  flex-direction: column;
  gap: var(--sp-6);
}

.brand { display: flex; align-items: center; gap: var(--sp-4); min-width: 0; }
.brand-mark {
  width: 28px; height: 28px; flex: none;
  display: grid; place-items: center;
  border-radius: var(--radius-sm);
  background: var(--accent);
  color: var(--text-inverse);
}
.brand-mark svg { width: 16px; height: 16px; }
.brand-text { min-width: 0; }
.brand-name { color: var(--text-primary); font-size: 13px; font-weight: 600; letter-spacing: -0.005em; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.brand-meta { font-size: 11px; color: var(--text-muted); font-variant-numeric: tabular-nums; }

.nav-group { display: flex; flex-direction: column; gap: var(--sp-1); }
.nav-label {
  font-size: 11px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase;
  color: var(--text-muted); padding: 0 var(--sp-4) var(--sp-2);
}
.nav-link {
  display: flex; align-items: center; gap: var(--sp-4);
  padding: var(--sp-3) var(--sp-4);
  border-radius: var(--radius-sm);
  color: var(--text-secondary);
  font-size: 13px;
  transition: background var(--duration-fast) var(--ease-out), color var(--duration-fast) var(--ease-out);
}
.nav-link:hover { background: var(--surface-raised); color: var(--text-primary); text-decoration: none; }
.nav-link[aria-current="page"] { background: var(--accent-subtle); color: var(--text-primary); font-weight: 500; }
.nav-link svg { width: 15px; height: 15px; flex: none; opacity: 0.85; }
.nav-link .count { margin-left: auto; font-size: 12px; color: var(--text-muted); font-variant-numeric: tabular-nums; }

.sidebar-foot { margin-top: auto; padding-top: var(--sp-5); border-top: 1px solid var(--border-subtle); font-size: 12px; color: var(--text-muted); }
.sidebar-foot a { color: var(--text-secondary); }

.main { min-width: 0; display: flex; flex-direction: column; }

.topbar {
  position: sticky; top: 0; z-index: 20;
  height: var(--topbar-h); flex: none;
  display: flex; align-items: center; gap: var(--sp-5);
  padding: 0 var(--sp-7);
  background: color-mix(in srgb, var(--bg-base) 88%, transparent);
  backdrop-filter: blur(8px);
  border-bottom: 1px solid var(--border-subtle);
}
.menu-btn { display: none; }

.crumb { font-size: 13px; color: var(--text-muted); display: flex; align-items: center; gap: var(--sp-3); min-width: 0; }
.crumb strong { color: var(--text-primary); font-weight: 500; }
.crumb .sep { opacity: 0.5; }

.topbar-actions { margin-left: auto; display: flex; align-items: center; gap: var(--sp-4); }

.icon-btn {
  display: inline-grid; place-items: center;
  width: 32px; height: 32px;
  border: 1px solid var(--border-strong);
  background: var(--surface);
  border-radius: var(--radius-sm);
  cursor: pointer;
  color: var(--text-secondary);
  transition: background var(--duration-fast) var(--ease-out), color var(--duration-fast) var(--ease-out), border-color var(--duration-fast) var(--ease-out);
}
.icon-btn:hover { background: var(--surface-raised); color: var(--text-primary); border-color: var(--border-strong); }
.icon-btn svg { width: 16px; height: 16px; }

.content { padding: var(--sp-9) var(--sp-7) var(--sp-12); }
.content-inner { max-width: 1040px; margin: 0 auto; }
.content-inner.narrow { max-width: 760px; }

/* ------------------------------------------------------------------ *
 * Hero
 * ------------------------------------------------------------------ */

.hero { padding: var(--sp-10) 0 var(--sp-9); border-bottom: 1px solid var(--border-subtle); }
.eyebrow {
  font-size: 11px; font-weight: 600; letter-spacing: 0.05em; text-transform: uppercase;
  color: var(--accent); margin-bottom: var(--sp-5);
}
.hero h1 { font-size: 32px; max-width: 22ch; }
.hero .lede { margin: var(--sp-5) 0 0; font-size: 16px; color: var(--text-secondary); max-width: 62ch; }

.hero-actions { display: flex; flex-wrap: wrap; gap: var(--sp-4); margin-top: var(--sp-7); }

.btn {
  display: inline-flex; align-items: center; gap: var(--sp-3);
  height: 34px; padding: 0 var(--sp-6);
  border-radius: var(--radius-sm);
  border: 1px solid var(--border-strong);
  background: var(--surface);
  color: var(--text-primary);
  font-size: 13px; font-weight: 500;
  cursor: pointer;
  transition: background var(--duration-fast) var(--ease-out), border-color var(--duration-fast) var(--ease-out);
}
.btn:hover { background: var(--surface-raised); border-color: var(--border-strong); text-decoration: none; color: var(--text-primary); }
.btn svg { width: 15px; height: 15px; }
/* A filled button's shape is its fill, which contrasts with the page — no edge needed. */
.btn-primary { background: var(--accent); border-color: transparent; color: var(--text-inverse); }
.btn-primary:hover { background: var(--accent-hover); border-color: var(--accent-hover); color: var(--text-inverse); }

/* Key-value spec row — dense, labelled, scannable */
.specs { display: flex; flex-wrap: wrap; gap: var(--sp-8); margin-top: var(--sp-9); }
.spec { min-width: 96px; }
.spec dt { font-size: 11px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase; color: var(--text-muted); }
.spec dd { margin: var(--sp-2) 0 0; font-size: 16px; font-weight: 500; font-variant-numeric: tabular-nums; }

.section { padding: var(--sp-9) 0; border-bottom: 1px solid var(--border-subtle); }
.section:last-child { border-bottom: 0; }
.section h2 { font-size: 20px; margin-bottom: var(--sp-5); }
.section h3 { font-size: 16px; margin: var(--sp-8) 0 var(--sp-4); }
.section > p { color: var(--text-secondary); max-width: 68ch; }

/* ------------------------------------------------------------------ *
 * Code
 * ------------------------------------------------------------------ */

.code-block {
  position: relative;
  margin: var(--sp-5) 0;
  background: var(--surface-sunken);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  overflow: hidden;
}
.code-head {
  display: flex; align-items: center; gap: var(--sp-4);
  padding: var(--sp-3) var(--sp-4) var(--sp-3) var(--sp-6);
  border-bottom: 1px solid var(--border-subtle);
  background: var(--surface);
  font-size: 11px; letter-spacing: 0.04em; text-transform: uppercase; color: var(--text-muted);
}
.code-head .spacer { margin-left: auto; }
.code-block pre {
  margin: 0; padding: var(--sp-6);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 13px; line-height: 1.6;
  tab-size: 2;
}
.code-block code { font-family: inherit; color: var(--text-primary); }

code:not(pre code) {
  font-family: var(--font-mono);
  font-size: 0.9em;
  padding: 1px 5px;
  background: var(--surface-raised);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-sm);
  color: var(--text-primary);
}

.copy-btn {
  display: inline-flex; align-items: center; gap: var(--sp-2);
  height: 24px; padding: 0 var(--sp-4);
  background: var(--surface-raised);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-sm);
  color: var(--text-secondary);
  font-size: 11px; font-weight: 500; letter-spacing: 0.02em; text-transform: none;
  cursor: pointer;
  transition: background var(--duration-fast) var(--ease-out), color var(--duration-fast) var(--ease-out);
}
.copy-btn:hover { background: var(--surface-overlay); color: var(--text-primary); }
.copy-btn[data-copied="true"] { color: var(--success); border-color: var(--success); }
.copy-btn svg { width: 12px; height: 12px; }

.tok-comment { color: var(--code-comment); font-style: italic; }
.tok-string { color: var(--code-string); }
.tok-keyword { color: var(--code-keyword); }
.tok-number { color: var(--code-number); }
.tok-func { color: var(--code-func); }

/* ------------------------------------------------------------------ *
 * API reference
 * ------------------------------------------------------------------ */

.api-toolbar { position: sticky; top: var(--topbar-h); z-index: 10; background: var(--bg-base); padding: var(--sp-6) 0 var(--sp-5); border-bottom: 1px solid var(--border-subtle); }
.search-field { position: relative; display: flex; align-items: center; }
.search-field svg { position: absolute; left: var(--sp-5); width: 15px; height: 15px; color: var(--text-muted); pointer-events: none; }
.search-input {
  width: 100%; height: 38px;
  padding: 0 var(--sp-10) 0 var(--sp-9);
  background: var(--surface);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius-sm);
  color: var(--text-primary);
  font-size: 14px;
}
.search-input::placeholder { color: var(--text-muted); }
.search-input:focus-visible { outline: 2px solid var(--focus-ring); outline-offset: 1px; }
.search-kbd {
  position: absolute; right: var(--sp-4);
  font-family: var(--font-mono); font-size: 11px; color: var(--text-muted);
  border: 1px solid var(--border-subtle); border-radius: var(--radius-sm);
  padding: 1px 5px; background: var(--surface-raised);
}

.chips { display: flex; flex-wrap: wrap; gap: var(--sp-3); margin-top: var(--sp-5); }
.chip {
  height: 26px; padding: 0 var(--sp-5);
  display: inline-flex; align-items: center; gap: var(--sp-3);
  background: var(--surface); border: 1px solid var(--border-strong);
  border-radius: var(--radius-pill);
  color: var(--text-secondary); font-size: 12px; cursor: pointer;
  transition: background var(--duration-fast) var(--ease-out), color var(--duration-fast) var(--ease-out), border-color var(--duration-fast) var(--ease-out);
}
.chip:hover { background: var(--surface-raised); color: var(--text-primary); }
.chip[aria-pressed="true"] { background: var(--accent-subtle); border-color: var(--accent); color: var(--text-primary); }
.chip .n { color: var(--text-muted); font-variant-numeric: tabular-nums; }

.api-count { margin-top: var(--sp-5); font-size: 12px; color: var(--text-muted); font-variant-numeric: tabular-nums; }

.methods { margin-top: var(--sp-5); display: flex; flex-direction: column; }
.method {
  border-bottom: 1px solid var(--border-subtle);
  scroll-margin-top: calc(var(--topbar-h) + var(--api-toolbar-h, 196px) + var(--sp-6));
}
.method[hidden] { display: none; }
.method-head {
  width: 100%; display: flex; align-items: baseline; gap: var(--sp-5);
  padding: var(--sp-5) var(--sp-4);
  background: none; border: 0; text-align: left; cursor: pointer;
  transition: background var(--duration-fast) var(--ease-out);
}
.method-head:hover { background: var(--surface); }
.method-name { font-family: var(--font-mono); font-size: 13px; font-weight: 600; color: var(--text-primary); }
.method-name::before { content: "bot."; color: var(--text-muted); font-weight: 400; }
.method-sig { font-family: var(--font-mono); font-size: 12px; color: var(--text-muted); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }
.method-cat { margin-left: auto; font-size: 11px; text-transform: uppercase; letter-spacing: 0.04em; color: var(--text-muted); flex: none; }
.method-body { padding: 0 var(--sp-4) var(--sp-7); }
.method[data-open="true"] .method-head { background: var(--surface); }
.method-desc { color: var(--text-secondary); max-width: 78ch; margin: 0 0 var(--sp-5); }

.params { width: 100%; border-collapse: collapse; font-size: 13px; }
.params th {
  text-align: left; font-size: 11px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase;
  color: var(--text-muted); padding: var(--sp-3) var(--sp-5) var(--sp-3) 0; border-bottom: 1px solid var(--border-subtle);
}
.params td { padding: var(--sp-4) var(--sp-5) var(--sp-4) 0; border-bottom: 1px solid var(--border-subtle); vertical-align: top; color: var(--text-secondary); }
.params tr:last-child td { border-bottom: 0; }
.params .p-name { font-family: var(--font-mono); color: var(--text-primary); white-space: nowrap; }
.params .p-type { font-family: var(--font-mono); font-size: 12px; color: var(--accent); white-space: nowrap; }
.params .p-type .opt { color: var(--text-muted); }

.meta-row { display: flex; flex-wrap: wrap; gap: var(--sp-3) var(--sp-6); margin-top: var(--sp-5); font-size: 12px; color: var(--text-muted); }
.meta-row .k { color: var(--text-secondary); }
.meta-row a { font-family: var(--font-mono); }

.empty {
  padding: var(--sp-11) var(--sp-6);
  text-align: center; color: var(--text-muted);
  border: 1px dashed var(--border-subtle); border-radius: var(--radius-md);
  margin-top: var(--sp-6);
}
.empty strong { display: block; color: var(--text-primary); font-size: 15px; margin-bottom: var(--sp-3); font-weight: 500; }

/* ------------------------------------------------------------------ *
 * Prose (rendered markdown)
 * ------------------------------------------------------------------ */

.prose { max-width: 72ch; color: var(--text-secondary); }
.prose h1 { font-size: 28px; color: var(--text-primary); margin: var(--sp-9) 0 var(--sp-5); }
.prose h2 { font-size: 20px; color: var(--text-primary); margin: var(--sp-9) 0 var(--sp-5); padding-top: var(--sp-5); }
.prose h3 { font-size: 16px; color: var(--text-primary); margin: var(--sp-7) 0 var(--sp-4); }
.prose h1:first-child, .prose h2:first-child { margin-top: 0; }
.prose p { margin: 0 0 var(--sp-5); }
.prose ul, .prose ol { margin: 0 0 var(--sp-5); padding-left: var(--sp-8); }
.prose li { margin-bottom: var(--sp-3); }
.prose li > ul, .prose li > ol { margin-top: var(--sp-3); }
.prose strong { color: var(--text-primary); font-weight: 600; }
.prose hr { border: 0; border-top: 1px solid var(--border-subtle); margin: var(--sp-8) 0; }
.prose blockquote {
  margin: 0 0 var(--sp-6);
  padding: var(--sp-4) var(--sp-6);
  border-left: 2px solid var(--accent-border);
  background: var(--surface);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
}
.prose blockquote p:last-child { margin-bottom: 0; }
.prose img { max-width: 100%; }

.table-wrap { overflow-x: auto; margin: 0 0 var(--sp-6); border: 1px solid var(--border-subtle); border-radius: var(--radius-md); }
.prose table, .table-wrap table { width: 100%; border-collapse: collapse; font-size: 13px; }
.prose th, .table-wrap th {
  text-align: left; font-size: 11px; font-weight: 600; letter-spacing: 0.04em; text-transform: uppercase;
  color: var(--text-muted); padding: var(--sp-4) var(--sp-6); background: var(--surface); border-bottom: 1px solid var(--border-subtle);
}
.prose td, .table-wrap td { padding: var(--sp-4) var(--sp-6); border-bottom: 1px solid var(--border-subtle); color: var(--text-secondary); vertical-align: top; }
.prose tr:last-child td, .table-wrap tr:last-child td { border-bottom: 0; }

.page-title { font-size: 28px; padding-bottom: var(--sp-6); border-bottom: 1px solid var(--border-subtle); margin-bottom: var(--sp-8); }

/* Callout */
.callout {
  display: flex; gap: var(--sp-5);
  padding: var(--sp-6);
  border: 1px solid var(--border-subtle);
  border-left-width: 2px;
  border-radius: var(--radius-md);
  background: var(--surface);
  margin: var(--sp-6) 0;
  font-size: 14px; color: var(--text-secondary);
}
.callout svg { width: 16px; height: 16px; flex: none; margin-top: 2px; }
.callout strong { color: var(--text-primary); }
.callout.tip { border-left-color: var(--accent); }
.callout.tip svg { color: var(--accent); }
.callout.warn { border-left-color: var(--warning); }
.callout.warn svg { color: var(--warning); }

/* ------------------------------------------------------------------ *
 * Responsive
 * ------------------------------------------------------------------ */

.backdrop { display: none; position: fixed; inset: 0; z-index: 30; background: rgb(0 0 0 / 0.55); }

@media (max-width: 900px) {
  .app { grid-template-columns: 1fr; }
  .menu-btn { display: inline-grid; }
  .sidebar {
    position: fixed; z-index: 40; top: 0; left: 0;
    width: min(300px, 84vw);
    transform: translateX(-100%);
    transition: transform var(--duration-base) var(--ease-out);
  }
  .app[data-nav="open"] .sidebar { transform: none; }
  .app[data-nav="open"] .backdrop { display: block; }
  .content { padding: var(--sp-8) var(--sp-6) var(--sp-12); }
  .topbar { padding: 0 var(--sp-6); }
  .hero h1 { font-size: 26px; }
  .specs { gap: var(--sp-7); }
}

@media (max-width: 560px) {
  .content { padding: var(--sp-7) var(--sp-5) var(--sp-11); }
  .hero { padding: var(--sp-8) 0 var(--sp-7); }
  .method-head { flex-wrap: wrap; gap: var(--sp-2) var(--sp-5); }
  .method-cat { display: none; }
  .method-sig { flex-basis: 100%; }
}

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
    scroll-behavior: auto !important;
  }
}