/* tunnelcat-sdk hypertext docs — extends Web/tunnelcat/style.css tokens with
   a docs-shell layout (sidebar + content + code blocks + API tables). */

@import url('https://fonts.googleapis.com/css2?family=Oswald:wght@500;700&family=IBM+Plex+Sans:wght@400;500;600&family=IBM+Plex+Mono:wght@400;500;600&display=swap');

:root {
  --tc-yellow-primary: #DC9518;
  --tc-yellow-light:   #DF9717;
  --tc-yellow-dark:    #BA7E1A;
  --tc-dark-primary:   #0D1720;
  --tc-black:          #070B0F;
  --tc-off-white:      #E6E1DA;
  --tc-metal-dark:     #333232;
  --tc-metal-mid:      #625C59;
  --tc-metal-light:    #9E948B;
  --tc-dust:           #CEA65A;

  --docs-sidebar-w: 280px;
  --docs-content-max: 860px;
  --docs-code-bg: #0A1119;
  --docs-code-border: #1E2A35;
  --docs-good: #7CC576;
  --docs-warn: #E0A63A;
  --docs-bad:  #EF6B4D;
}

* { box-sizing: border-box; }

html, body {
  margin: 0; padding: 0;
  background: var(--tc-dark-primary);
  color: var(--tc-off-white);
  font-family: "IBM Plex Sans", "Segoe UI", Arial, sans-serif;
  font-size: 16px;
  line-height: 1.65;
}

a { color: var(--tc-yellow-primary); text-decoration: none; }
a:hover { text-decoration: underline; }
a.silent { color: inherit; text-decoration: none; }
a.silent:hover { text-decoration: none; }

h1, h2, h3, h4 {
  font-family: "Oswald", "Arial Narrow", sans-serif;
  text-transform: uppercase;
  letter-spacing: .01em;
  color: var(--tc-off-white);
  line-height: 1.2;
  margin: 0 0 .5em;
}
h1 { font-size: clamp(28px, 4vw, 40px); }
h2 { font-size: 24px; margin-top: 2.4em; padding-top: .3em; border-top: 1px solid var(--tc-metal-dark); }
h2:first-of-type { margin-top: 0; padding-top: 0; border-top: none; }
h3 { font-size: 18px; margin-top: 1.8em; color: var(--tc-yellow-primary); text-transform: none; letter-spacing: 0; }
h4 { font-size: 15px; margin-top: 1.4em; text-transform: none; letter-spacing: 0; color: var(--tc-off-white); font-family: "IBM Plex Sans", sans-serif; font-weight: 600; }

p { margin: 0 0 1em; color: var(--tc-off-white); }
p.lede { font-size: 18px; color: var(--tc-metal-light); max-width: 640px; }

code {
  font-family: "IBM Plex Mono", ui-monospace, Consolas, monospace;
  font-size: .88em;
  background: var(--docs-code-bg);
  border: 1px solid var(--docs-code-border);
  border-radius: 3px;
  padding: .1em .4em;
  color: var(--tc-dust);
}

pre {
  font-family: "IBM Plex Mono", ui-monospace, Consolas, monospace;
  font-size: 13.5px;
  line-height: 1.6;
  background: var(--docs-code-bg);
  border: 1px solid var(--docs-code-border);
  border-left: 3px solid var(--tc-yellow-dark);
  border-radius: 4px;
  padding: 16px 18px;
  overflow-x: auto;
  margin: 0 0 1.4em;
  color: #D8D2C8;
}
pre code { background: none; border: none; padding: 0; color: inherit; font-size: 1em; }

/* Minimal manual token coloring for readability, applied via <span> in
   source — see docs.js's tiny highlighter. */
.tok-kw   { color: #E0A63A; }
.tok-str  { color: #9FC97A; }
.tok-com  { color: var(--tc-metal-light); font-style: italic; }
.tok-type { color: #7BB3E0; }
.tok-fn   { color: #DCC97E; }

ul, ol { padding-left: 1.4em; margin: 0 0 1.2em; }
li { margin-bottom: .4em; }

hr { border: none; border-top: 1px solid var(--tc-metal-dark); margin: 2.4em 0; }

blockquote {
  margin: 0 0 1.4em;
  padding: 4px 18px;
  border-left: 3px solid var(--tc-metal-mid);
  color: var(--tc-metal-light);
}

/* ── Callouts ───────────────────────────────────────────────────── */
.callout {
  border: 1px solid var(--tc-metal-dark);
  border-left-width: 4px;
  border-radius: 4px;
  padding: 14px 18px;
  margin: 0 0 1.6em;
  font-size: 14.5px;
}
.callout p:last-child { margin-bottom: 0; }
.callout-title {
  font-family: "IBM Plex Sans", sans-serif;
  font-weight: 700;
  font-size: 12px;
  letter-spacing: .06em;
  text-transform: uppercase;
  margin-bottom: 6px;
  display: flex; align-items: center; gap: 6px;
}
.callout-note    { border-left-color: var(--tc-yellow-primary); background: rgba(220,149,24,.05); }
.callout-note .callout-title { color: var(--tc-yellow-primary); }
.callout-warn    { border-left-color: var(--docs-warn); background: rgba(224,166,58,.06); }
.callout-warn .callout-title { color: var(--docs-warn); }
.callout-danger  { border-left-color: var(--docs-bad); background: rgba(239,107,77,.06); }
.callout-danger .callout-title { color: var(--docs-bad); }
.callout-status  { border-left-color: var(--docs-good); background: rgba(124,197,118,.05); }
.callout-status .callout-title { color: var(--docs-good); }

/* ── Tables ─────────────────────────────────────────────────────── */
.table-wrap { overflow-x: auto; margin: 0 0 1.6em; border: 1px solid var(--tc-metal-dark); border-radius: 4px; }
table { width: 100%; border-collapse: collapse; font-size: 14px; }
th {
  text-align: left; padding: 10px 14px; background: var(--tc-black);
  font-family: "IBM Plex Sans", sans-serif; font-weight: 700; font-size: 11.5px;
  letter-spacing: .05em; text-transform: uppercase; color: var(--tc-metal-light);
  border-bottom: 1px solid var(--tc-metal-dark); white-space: nowrap;
}
td { padding: 10px 14px; border-bottom: 1px solid var(--tc-metal-dark); vertical-align: top; }
tr:last-child td { border-bottom: none; }
td code, th code { white-space: nowrap; }

/* ── API reference blocks ──────────────────────────────────────── */
.api-entry {
  border: 1px solid var(--tc-metal-dark);
  border-radius: 6px;
  margin: 0 0 18px;
  overflow: hidden;
}
.api-sig {
  background: var(--tc-black);
  padding: 12px 16px;
  font-family: "IBM Plex Mono", monospace;
  font-size: 13.5px;
  color: var(--tc-off-white);
  border-bottom: 1px solid var(--tc-metal-dark);
  overflow-x: auto;
  white-space: pre;
}
.api-sig .tok-fn { color: var(--tc-yellow-primary); font-weight: 600; }
.api-body { padding: 14px 16px; font-size: 14px; }
.api-body p:last-child { margin-bottom: 0; }
.api-body dl { margin: 10px 0 0; }
.api-body dt { font-family: "IBM Plex Mono", monospace; font-size: 13px; color: var(--tc-dust); margin-top: 8px; }
.api-body dd { margin: 2px 0 0; color: var(--tc-metal-light); font-size: 13.5px; }

/* ── Layout shell ───────────────────────────────────────────────── */
.docs-shell { display: flex; min-height: 100vh; }

.docs-topbar {
  position: fixed; top: 0; left: 0; right: 0; height: 56px; z-index: 50;
  display: flex; align-items: center; justify-content: space-between;
  padding: 0 20px;
  background: var(--tc-black);
  border-bottom: 3px solid var(--tc-yellow-primary);
}
.docs-topbar .brand { display: flex; align-items: center; gap: 10px; font-family: "Oswald", sans-serif; font-weight: 700; text-transform: uppercase; font-size: 15px; }
.docs-topbar .brand img { height: 28px; width: 28px; border-radius: 50%; }
.docs-topbar .brand span { color: var(--tc-yellow-primary); }
.docs-topbar .topbar-links { display: flex; align-items: center; gap: 18px; font-size: 13.5px; }
.docs-topbar .topbar-links a { color: var(--tc-metal-light); }
.docs-topbar .topbar-links a:hover { color: var(--tc-yellow-primary); }
.docs-topbar .sidebar-toggle {
  display: none; width: 36px; height: 36px; border-radius: 6px;
  border: 1px solid var(--tc-metal-dark); background: transparent; cursor: pointer;
  flex-direction: column; align-items: center; justify-content: center; gap: 4px;
}
.docs-topbar .sidebar-toggle span { display: block; width: 16px; height: 2px; background: var(--tc-off-white); }

.docs-sidebar {
  position: fixed; top: 56px; bottom: 0; left: 0; width: var(--docs-sidebar-w);
  overflow-y: auto;
  background: var(--tc-black);
  border-right: 1px solid var(--tc-metal-dark);
  padding: 22px 0 40px;
  z-index: 40;
}
.docs-nav-group { margin-bottom: 22px; }
.docs-nav-label {
  font-family: "IBM Plex Sans", sans-serif;
  font-size: 11px; font-weight: 700; letter-spacing: .08em; text-transform: uppercase;
  color: var(--tc-metal-mid); padding: 0 22px; margin-bottom: 8px;
}
.docs-nav-group a {
  display: block; padding: 7px 22px; font-size: 14px; color: var(--tc-metal-light);
  border-left: 2px solid transparent;
}
.docs-nav-group a:hover { color: var(--tc-off-white); text-decoration: none; background: rgba(220,149,24,.04); }
.docs-nav-group a.active {
  color: var(--tc-yellow-primary); border-left-color: var(--tc-yellow-primary);
  background: rgba(220,149,24,.08); font-weight: 600;
}
.docs-nav-group a .lang-icon { display: inline-block; width: 16px; text-align: center; margin-right: 6px; opacity: .8; font-family: "IBM Plex Mono", monospace; font-size: 11px; }

.docs-main {
  margin-left: var(--docs-sidebar-w);
  margin-top: 56px;
  flex: 1;
  min-width: 0;
  display: flex;
  justify-content: center;
  padding: 48px 40px 100px;
}
.docs-content { max-width: var(--docs-content-max); width: 100%; }

.docs-breadcrumb { font-size: 12.5px; color: var(--tc-metal-mid); margin-bottom: 14px; font-family: "IBM Plex Sans", sans-serif; text-transform: uppercase; letter-spacing: .04em; }
.docs-breadcrumb a { color: var(--tc-metal-light); }

.docs-pager {
  display: flex; justify-content: space-between; gap: 16px; margin-top: 3em;
  padding-top: 24px; border-top: 1px solid var(--tc-metal-dark);
}
.docs-pager a {
  flex: 1; max-width: 48%; border: 1px solid var(--tc-metal-dark); border-radius: 6px;
  padding: 14px 16px; color: var(--tc-off-white); display: block;
}
.docs-pager a:hover { border-color: var(--tc-yellow-primary); text-decoration: none; }
.docs-pager .pager-dir { font-size: 11px; color: var(--tc-metal-light); text-transform: uppercase; letter-spacing: .05em; margin-bottom: 4px; }
.docs-pager .pager-next { text-align: right; margin-left: auto; }

.lang-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(210px, 1fr)); gap: 14px; margin: 24px 0; }
.lang-card {
  border: 1px solid var(--tc-metal-dark); border-radius: 8px; padding: 20px;
  background: var(--tc-black); display: block; color: var(--tc-off-white);
  transition: border-color .15s, transform .15s;
}
.lang-card:hover { border-color: var(--tc-yellow-primary); transform: translateY(-2px); text-decoration: none; }
.lang-card .lang-name { font-family: "Oswald", sans-serif; font-size: 18px; text-transform: uppercase; margin-bottom: 6px; }
.lang-card .lang-desc { font-size: 13px; color: var(--tc-metal-light); margin-bottom: 10px; }

.arch-flow { display: flex; flex-direction: column; gap: 0; margin: 28px 0; }
.arch-layer {
  border: 1px solid var(--tc-metal-dark); border-radius: 6px; padding: 16px 20px;
  background: var(--tc-black); position: relative;
}
.arch-layer + .arch-layer { margin-top: 22px; }
.arch-layer + .arch-layer::before {
  content: "↓"; position: absolute; top: -24px; left: 20px; color: var(--tc-yellow-primary); font-size: 18px;
}
.arch-layer .layer-tag { font-size: 11px; font-weight: 700; letter-spacing: .06em; text-transform: uppercase; color: var(--tc-yellow-primary); margin-bottom: 4px; }
.arch-layer h4 { margin: 0 0 4px; }
.arch-layer p { font-size: 13.5px; color: var(--tc-metal-light); margin: 0; }

footer.docs-footer {
  margin-left: var(--docs-sidebar-w);
  border-top: 1px solid var(--tc-metal-dark);
  padding: 24px 40px;
  font-size: 12.5px;
  color: var(--tc-metal-mid);
  display: flex; justify-content: space-between; flex-wrap: wrap; gap: 8px;
}

@media (max-width: 980px) {
  .docs-topbar .sidebar-toggle { display: flex; }
  .docs-topbar .topbar-links { display: none; }
  .docs-sidebar { transform: translateX(-100%); transition: transform .2s; box-shadow: 4px 0 24px rgba(0,0,0,.5); }
  .docs-sidebar.open { transform: translateX(0); }
  .docs-main, footer.docs-footer { margin-left: 0; padding-left: 20px; padding-right: 20px; }
}