/* EzRouter docs — page-specific styles.
   Tokens + shared nav live in ../shared/tokens.css */

/* ─── Layout ──────────────────────────────────────────────────────────── */
.docs-layout {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 220px;
  gap: var(--space-10);
  max-width: var(--container-wide);
  margin: 0 auto;
  padding: var(--space-8) var(--space-6) var(--space-16);
}

/* ─── Left sidebar ────────────────────────────────────────────────────── */
.docs-sidebar,
.docs-toc {
  position: sticky;
  top: calc(var(--nav-height) + var(--space-6));
  align-self: start;
  max-height: calc(100vh - var(--nav-height) - var(--space-8));
  overflow-y: auto;
  scrollbar-width: thin;
}
.docs-sidebar__group {
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-faint);
  margin: var(--space-5) 0 var(--space-2);
  padding: 0 var(--space-3);
}
.docs-sidebar__group:first-child { margin-top: 0; }
.docs-sidebar__link {
  display: flex;
  align-items: center;
  width: 100%;
  padding: 6px var(--space-3);
  border-radius: var(--radius);
  font-size: 14px;
  color: var(--text-muted);
  border: none;
  background: transparent;
  text-align: left;
  font-family: inherit;
  cursor: pointer;
  transition: background 0.15s ease, color 0.15s ease;
}
.docs-sidebar__link:hover { background: var(--accents-1); color: var(--text); }
.docs-sidebar__link.is-active { background: var(--accents-2); color: var(--text); font-weight: 500; }

/* ─── Content typography ──────────────────────────────────────────────── */
.docs-content {
  max-width: 720px;
  font-size: 16px;
  line-height: 1.7;
  color: var(--text);
}
.docs-content > header { margin-bottom: var(--space-8); }
.docs-content h1 {
  font-size: 40px;
  line-height: 1.1;
  letter-spacing: -0.03em;
  margin: 0 0 var(--space-4);
}
.docs-content .chapter__intro {
  font-size: 18px;
  line-height: 1.6;
  color: var(--text-muted);
  margin: 0;
  max-width: 58ch;
  text-wrap: pretty;
}
.docs-content h2 {
  font-size: 22px;
  letter-spacing: -0.015em;
  margin: var(--space-10) 0 var(--space-3);
  scroll-margin-top: calc(var(--nav-height) + var(--space-4));
}
.docs-content h2 a {
  color: inherit;
  text-decoration: none;
  position: relative;
}
.docs-content h2 a::before {
  content: "#";
  position: absolute;
  left: -18px;
  color: var(--text-faint);
  opacity: 0;
  transition: opacity 0.15s ease;
}
.docs-content h2:hover a::before { opacity: 1; }
.docs-content h3 {
  font-size: 16px;
  margin: var(--space-6) 0 var(--space-2);
  letter-spacing: -0.01em;
}
.docs-content p {
  margin: var(--space-4) 0;
  text-wrap: pretty;
}
.docs-content a:not(.docs-sidebar__link):not(.docs-toc__link):not(.btn) {
  color: var(--brand);
  text-decoration: none;
  border-bottom: 1px solid transparent;
}
.docs-content a:not(.docs-sidebar__link):not(.docs-toc__link):not(.btn):hover {
  border-color: currentColor;
}
.docs-content code {
  font-family: var(--font-mono);
  font-size: 13px;
  background: var(--accents-1);
  border: 1px solid var(--border);
  padding: 1px 6px;
  border-radius: var(--radius-sm);
}
.docs-content ul,
.docs-content ol {
  margin: var(--space-4) 0;
  padding-left: var(--space-6);
}
.docs-content li { margin: var(--space-2) 0; }
.docs-content li::marker { color: var(--text-faint); }
.docs-content strong { font-weight: 600; }

/* ─── Code block ──────────────────────────────────────────────────────── */
.code-block {
  position: relative;
  margin: var(--space-4) 0;
  background: #0a0a0a;
  border: 1px solid #1f1f1f;
  border-radius: var(--radius-md);
  overflow: hidden;
}
.code-block__head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: var(--space-2) var(--space-4);
  background: #141414;
  border-bottom: 1px solid #1f1f1f;
}
.code-block__lang {
  font-family: var(--font-mono);
  font-size: 11px;
  color: #888;
  letter-spacing: 0.04em;
  text-transform: uppercase;
}
.code-block__copy {
  padding: 4px 10px;
  background: rgba(255, 255, 255, 0.06);
  color: #ccc;
  border: 1px solid rgba(255, 255, 255, 0.12);
  border-radius: var(--radius);
  font-family: var(--font-mono);
  font-size: 11px;
  cursor: pointer;
  transition: background 0.15s ease, color 0.15s ease;
}
.code-block__copy:hover { background: rgba(255, 255, 255, 0.12); color: #fff; }
.code-block__copy.is-copied { color: var(--brand); border-color: var(--brand); }
.code-block pre {
  margin: 0;
  padding: var(--space-4) var(--space-5);
  font-family: var(--font-mono);
  font-size: 13px;
  line-height: 1.7;
  color: #e8e8e8;
  white-space: pre;
  overflow-x: auto;
}
.code-block .tk-prompt { color: var(--brand); user-select: none; }
.code-block .tk-flag { color: #ffaa66; }
.code-block .tk-str { color: #a6e3a1; }
.code-block .tk-kw { color: #89b4fa; }
.code-block .tk-num { color: #fab387; }
.code-block .tk-comment { color: #6b7280; font-style: italic; }

/* ─── Callouts ────────────────────────────────────────────────────────── */
.callout {
  margin: var(--space-5) 0;
  padding: var(--space-4) var(--space-5);
  border-radius: var(--radius-md);
  font-size: 14px;
  line-height: 1.6;
}
.callout__label {
  font-family: var(--font-mono);
  font-size: 10px;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  margin-right: var(--space-2);
}
.callout p { margin: 0; }
.callout p + p { margin-top: var(--space-2); }
.callout--info {
  background: rgba(0, 112, 243, 0.06);
  border: 1px solid rgba(0, 112, 243, 0.2);
  color: var(--text);
}
.callout--info .callout__label { color: var(--brand); }
.callout--warn {
  background: rgba(245, 166, 35, 0.08);
  border: 1px solid rgba(245, 166, 35, 0.28);
  color: var(--text);
}
.callout--warn .callout__label { color: #8a5a00; }
.callout--tip {
  background: rgba(22, 163, 74, 0.06);
  border: 1px solid rgba(22, 163, 74, 0.22);
  color: var(--text);
}
.callout--tip .callout__label { color: #15803d; }

/* ─── Parameter table ─────────────────────────────────────────────────── */
.param-table {
  width: 100%;
  border-collapse: collapse;
  margin: var(--space-4) 0;
  font-size: 14px;
}
.param-table th {
  text-align: left;
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-faint);
  font-weight: 500;
  padding: var(--space-3) var(--space-3);
  border-bottom: 1px solid var(--border);
  background: var(--bg);
}
.param-table td {
  padding: var(--space-3) var(--space-3);
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}
.param-table td:first-child {
  font-family: var(--font-mono);
  font-size: 13px;
  white-space: nowrap;
  color: var(--text);
  font-weight: 500;
}
.param-table td:nth-child(2) {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--text-faint);
  white-space: nowrap;
}
.param-table td:nth-child(3) {
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--text-muted);
  white-space: nowrap;
}
.param-table td:last-child {
  color: var(--text-muted);
  line-height: 1.6;
}
.param-table td:last-child code {
  font-size: 12px;
}

/* ─── Prev / next footer ──────────────────────────────────────────────── */
.chapter-nav {
  margin-top: var(--space-16);
  padding-top: var(--space-6);
  border-top: 1px solid var(--border);
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: var(--space-4);
}
.chapter-nav__item {
  display: flex;
  flex-direction: column;
  gap: var(--space-1);
  padding: var(--space-4) var(--space-5);
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  font-family: inherit;
  text-align: left;
  cursor: pointer;
  color: inherit;
  text-decoration: none;
  transition: border-color 0.15s ease;
}
.chapter-nav__item:hover { border-color: var(--border-strong); }
.chapter-nav__item--next { grid-column: 2; text-align: right; align-items: flex-end; }
.chapter-nav__label {
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-faint);
}
.chapter-nav__title {
  font-size: 14px;
  font-weight: 500;
  color: var(--text);
}

/* ─── Right TOC ───────────────────────────────────────────────────────── */
.docs-toc { font-size: 13px; color: var(--text-muted); }
.docs-toc__label {
  font-family: var(--font-mono);
  font-size: 11px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-faint);
  margin-bottom: var(--space-3);
}
.docs-toc__link {
  display: block;
  padding: 4px 0 4px var(--space-3);
  border-left: 2px solid transparent;
  margin-left: -2px;
  color: var(--text-muted);
  text-decoration: none;
  line-height: 1.4;
  transition: color 0.15s ease, border-color 0.15s ease;
}
.docs-toc__link:hover { color: var(--text); }
.docs-toc__link.is-active {
  color: var(--brand);
  border-color: var(--brand);
}
.docs-toc__empty {
  color: var(--text-faint);
  font-style: italic;
  font-size: 12px;
}

/* ─── Playground ──────────────────────────────────────────────────────── */
.playground {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr);
  gap: var(--space-4);
  height: 520px;
  margin: var(--space-6) 0;
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  overflow: hidden;
  background: var(--surface);
}
.playground__params {
  padding: var(--space-5);
  background: var(--bg);
  border-right: 1px solid var(--border);
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
  overflow-y: auto;
}
.playground__chat {
  display: flex;
  flex-direction: column;
  min-height: 0;
}
.playground__transcript {
  flex: 1;
  overflow-y: auto;
  padding: var(--space-5);
  display: flex;
  flex-direction: column;
  gap: var(--space-4);
}
.playground__empty {
  flex: 1;
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--text-faint);
  font-size: 14px;
  text-align: center;
  text-wrap: pretty;
  padding: var(--space-6);
}
.playground__bubble {
  max-width: 80%;
  padding: var(--space-3) var(--space-4);
  border-radius: var(--radius-md);
  font-size: 14px;
  line-height: 1.6;
}
.playground__bubble--user {
  align-self: flex-end;
  background: var(--brand-soft);
  color: var(--text);
  border: 1px solid rgba(0, 112, 243, 0.2);
}
.playground__bubble--assistant {
  align-self: flex-start;
  background: var(--bg);
  color: var(--text);
  border: 1px solid var(--border);
  font-family: var(--font-mono);
  font-size: 13px;
  white-space: pre-wrap;
}
.playground__bubble--assistant.is-typing::after {
  content: "▋";
  color: var(--brand);
  margin-left: 2px;
  animation: caret 0.8s steps(1) infinite;
}
@keyframes caret {
  50% { opacity: 0; }
}
.playground__meta {
  margin-top: var(--space-1);
  font-family: var(--font-mono);
  font-size: 11px;
  color: var(--text-faint);
  letter-spacing: 0.02em;
}
.playground__composer {
  border-top: 1px solid var(--border);
  padding: var(--space-3) var(--space-4);
  display: flex;
  gap: var(--space-2);
  align-items: flex-end;
  background: var(--surface);
}
.playground__input {
  flex: 1;
  border: 1px solid var(--border-strong);
  border-radius: var(--radius);
  padding: var(--space-2) var(--space-3);
  font-family: inherit;
  font-size: 14px;
  resize: none;
  min-height: 40px;
  max-height: 120px;
  outline: none;
}
.playground__input:focus {
  border-color: var(--brand);
  box-shadow: 0 0 0 2px var(--brand-soft);
}
.playground__param-label {
  font-family: var(--font-mono);
  font-size: 10px;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--text-faint);
  margin-bottom: var(--space-2);
  display: flex;
  justify-content: space-between;
}
.playground__param-value {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--text);
  text-transform: none;
  letter-spacing: 0;
}
.playground__param-select {
  appearance: none;
  -webkit-appearance: none;
  width: 100%;
  padding: 6px 24px 6px 10px;
  font-family: var(--font-mono);
  font-size: 13px;
  background-color: var(--surface);
  border: 1px solid var(--border-strong);
  border-radius: var(--radius);
  color: var(--text);
  cursor: pointer;
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 16 16' fill='none' stroke='%23666' stroke-width='1.5'%3E%3Cpath d='M4 6l4 4 4-4'/%3E%3C/svg%3E");
  background-repeat: no-repeat;
  background-position: right 8px center;
}
.playground__param-range {
  width: 100%;
}

/* ─── Changelog timeline ─────────────────────────────────────────────── */
.changelog { display: flex; flex-direction: column; gap: var(--space-8); margin-top: var(--space-6); }
.changelog__entry {
  display: grid;
  grid-template-columns: 120px 1fr;
  gap: var(--space-6);
  padding-bottom: var(--space-6);
  border-bottom: 1px solid var(--border);
}
.changelog__entry:last-child { border-bottom: none; padding-bottom: 0; }
.changelog__meta {
  font-family: var(--font-mono);
  font-size: 12px;
  color: var(--text-faint);
  letter-spacing: 0.02em;
}
.changelog__version {
  display: inline-block;
  padding: 2px 8px;
  background: var(--accents-1);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  margin-top: var(--space-2);
  color: var(--text);
}
.changelog__title {
  font-size: 16px;
  font-weight: 600;
  letter-spacing: -0.01em;
  margin: 0 0 var(--space-2);
}
.changelog__body { color: var(--text-muted); font-size: 14px; line-height: 1.6; }
.changelog__body ul { margin: var(--space-2) 0; padding-left: var(--space-5); }
.changelog__body li { margin: 2px 0; }

/* ─── Responsive ──────────────────────────────────────────────────────── */
@media (max-width: 1080px) {
  .docs-layout { grid-template-columns: 220px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 860px) {
  .playground { grid-template-columns: 1fr; height: auto; }
  .playground__params { max-height: 240px; border-right: none; border-bottom: 1px solid var(--border); }
}
@media (max-width: 720px) {
  .docs-layout { grid-template-columns: 1fr; padding: var(--space-6) var(--space-4) var(--space-10); }
  .docs-sidebar { position: static; max-height: none; margin-bottom: var(--space-6); }
  .docs-content h1 { font-size: 32px; }
  .chapter-nav { grid-template-columns: 1fr; }
  .chapter-nav__item--next { grid-column: 1; }
}