/* ==========================================================================
   QPBOS — Dokumentacja Techniczna (Arkusz dedykowany)
   Układ dwukolumnowy: lewy sticky TOC + prawa kolumna treści (max 76ch).
   Wyłącznie zmienne systemowe z style.css, brak zewnętrznych zależności.
   ========================================================================== */

/* ── 1. NAGŁÓWEK DOKUMENTACJI (HERO) ─────────────────────────────────── */
/* Zapewnia spójne wprowadzenie do dokumentacji technicznej w estetyce konsoli */
.docs-hero-wrap {
  padding: 48px 0 32px;
  background: linear-gradient(180deg, var(--bg-hull) 0%, var(--bg-space) 100%);
  border-bottom: 1px solid var(--rule-subtle);
  position: relative;
}

.docs-hero {
  max-width: 960px;
}

.docs-badge {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--cryo-cyan);
  padding: 4px 10px;
  background: var(--cryo-cyan-dim);
  border: 1px solid var(--rule-accent);
  border-radius: var(--radius-xs);
  margin-bottom: 16px;
}

.docs-title {
  font-family: var(--font-heading);
  font-size: clamp(28px, 4vw, 44px);
  font-weight: 800;
  color: var(--text-primary);
  line-height: 1.15;
  letter-spacing: -0.02em;
  margin-bottom: 12px;
}

.docs-subtitle {
  font-size: 16px;
  line-height: 1.6;
  color: var(--text-secondary);
  margin-bottom: 20px;
  max-width: 72ch;
}

.docs-meta-strip {
  display: flex;
  flex-wrap: wrap;
  gap: 10px;
  align-items: center;
}

/* ── 2. SIATKA GŁÓWNA DOKUMENTACJI ────────────────────────────────────── */
/* Wymóg specyfikacji: .docs-grid na kontenerze nadrzędnym, display: grid */
.docs-main {
  padding: 40px 0 80px;
}

.docs-grid {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr);
  gap: 56px;
  align-items: start;
}

/* ── 3. LEWA KOLUMNA: SPIS TREŚCI (TOC) ──────────────────────────────── */
/* Wymóg: position: sticky, top: 88px, szerokość 260px, własny overflow-y */
.docs-toc {
  position: sticky;
  top: 88px;
  width: 260px;
  max-height: calc(100vh - 120px);
  overflow-y: auto;
  padding-right: 8px;
  scrollbar-width: thin;
  scrollbar-color: var(--rule-medium) transparent;
}

.docs-toc::-webkit-scrollbar {
  width: 4px;
}

.docs-toc::-webkit-scrollbar-thumb {
  background: var(--rule-medium);
  border-radius: 2px;
}

.docs-toc-header {
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-muted);
  padding: 0 10px 10px;
  border-bottom: 1px solid var(--rule-subtle);
  margin-bottom: 10px;
}

.docs-toc-list {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.docs-toc-item {
  margin: 0;
  padding: 0;
}

.docs-toc-link {
  display: block;
  padding: 6px 10px;
  font-family: var(--font-sans);
  font-size: 13px;
  line-height: 1.4;
  color: var(--text-secondary);
  text-decoration: none;
  border-left: 2px solid transparent;
  border-radius: var(--radius-xs);
  transition: color 0.15s ease, background 0.15s ease, border-left-color 0.15s ease;
}

.docs-toc-link:hover {
  color: var(--cryo-cyan);
  background: var(--cryo-cyan-dim);
}

/* Wymóg: widoczny focus i atrybut aria-current="true" */
.docs-toc-link:focus-visible {
  outline: 2px solid var(--cryo-cyan);
  outline-offset: 2px;
  color: var(--cryo-cyan);
}

.docs-toc-link.active,
.docs-toc-link[aria-current="true"] {
  color: var(--cryo-cyan);
  font-weight: 600;
  border-left-color: var(--cryo-cyan);
  background: var(--cryo-cyan-dim);
}

/* Przycisk zwijania TOC poniżej 900px */
.docs-toc-toggle-wrap {
  display: none;
}

.docs-toc-toggle {
  width: 100%;
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 12px 16px;
  background: var(--bg-surface);
  border: 1px solid var(--rule-medium);
  border-radius: var(--radius-xs);
  color: var(--text-primary);
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  cursor: pointer;
  transition: border-color 0.15s ease, background 0.15s ease;
}

.docs-toc-toggle:hover {
  border-color: var(--cryo-cyan);
}

.docs-toc-toggle:focus-visible {
  outline: 2px solid var(--cryo-cyan);
  outline-offset: 2px;
}

/* ── 4. PRAWA KOLUMNA: TREŚĆ DOKUMENTACJI ────────────────────────────── */
/* Wymóg: max-width 76ch dla optymalnej czytelności typograficznej */
.docs-body {
  max-width: 76ch;
  min-width: 0;
}

.docs-section {
  padding-top: 24px;
  margin-bottom: 56px;
  border-bottom: 1px solid var(--rule-subtle);
  padding-bottom: 48px;
}

.docs-section:last-child {
  border-bottom: none;
}

.docs-section-header {
  margin-bottom: 24px;
}

.docs-section-num {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 700;
  color: var(--cryo-cyan);
  letter-spacing: 0.1em;
  margin-bottom: 6px;
}

.docs-section h2 {
  font-family: var(--font-heading);
  font-size: clamp(22px, 3vw, 28px);
  font-weight: 700;
  color: var(--text-primary);
  line-height: 1.25;
  margin: 0 0 16px;
}

.docs-section h3 {
  font-family: var(--font-heading);
  font-size: 17px;
  font-weight: 600;
  color: var(--text-primary);
  margin: 28px 0 12px;
  line-height: 1.35;
}

.docs-section h4 {
  font-family: var(--font-mono);
  font-size: 13px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  color: var(--text-secondary);
  margin: 20px 0 10px;
}

.docs-section p {
  color: var(--text-secondary);
  font-size: 15px;
  line-height: 1.75;
  margin-bottom: 16px;
}

.docs-section strong {
  color: var(--text-primary);
  font-weight: 600;
}

.docs-section ul,
.docs-section ol {
  color: var(--text-secondary);
  font-size: 15px;
  line-height: 1.75;
  margin: 0 0 20px 24px;
  padding: 0;
}

.docs-section li {
  margin-bottom: 8px;
}

/* ── 5. WZORY MATEMATYCZNE I KOD ─────────────────────────────────────── */
/* Wzory bez bibliotek zewnętrznych: formatowane przez Unicode i indeksy */
.docs-section .math-block {
  padding: 16px 20px;
  background: var(--bg-surface);
  border: 1px solid var(--rule-subtle);
  border-left: 3px solid var(--cryo-cyan);
  border-radius: var(--radius-xs);
  font-family: var(--font-mono);
  font-size: 13px;
  color: var(--text-primary);
  margin: 18px 0;
  overflow-x: auto;
  line-height: 1.8;
  white-space: pre-wrap;
}

.docs-section .math-block.amber {
  border-left-color: var(--photonic-amber);
}

.docs-section pre {
  background: var(--bg-surface);
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-xs);
  padding: 16px 18px;
  margin: 18px 0;
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 12px;
  line-height: 1.6;
  color: var(--text-secondary);
}

.docs-section pre code {
  background: transparent;
  padding: 0;
  border: none;
  font-size: inherit;
  color: inherit;
}

.docs-section code {
  font-family: var(--font-mono);
  font-size: 12px;
  background: var(--bg-surface-elevated);
  border: 1px solid var(--rule-subtle);
  padding: 2px 6px;
  border-radius: 2px;
  color: var(--cryo-cyan);
}

/* Kolorowanie składni kodu laboratoryjnego */
.code-kw { color: var(--beryllium-blue); font-weight: 600; }
.code-fn { color: var(--cryo-cyan); }
.code-cm { color: var(--text-muted); font-style: italic; }
.code-nm { color: var(--photonic-amber); }
.code-st { color: var(--emerald-pass); }

/* ── 6. TABELE DOKUMENTACJI (PEŁNA RESPONSYWNOŚĆ) ────────────────────── */
/* Wymóg: każda tabela w kontenerze overflow-x: auto, zero poziomego przewijania */
.docs-table-wrap {
  width: 100%;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
  margin: 20px 0 24px;
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-xs);
  background: var(--bg-surface);
}

.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13px;
  line-height: 1.5;
  text-align: left;
}

.docs-table th {
  background: var(--bg-surface-elevated);
  padding: 12px 14px;
  font-family: var(--font-mono);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.05em;
  text-transform: uppercase;
  color: var(--text-primary);
  border-bottom: 1px solid var(--rule-medium);
  white-space: nowrap;
}

.docs-table td {
  padding: 12px 14px;
  border-bottom: 1px solid var(--rule-subtle);
  color: var(--text-secondary);
  vertical-align: top;
}

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

.docs-table tr:hover td {
  background: rgba(255, 255, 255, 0.02);
}

/* ── 7. KOMPONENTY BLOKOWE: ALERTY, KARTY, PRZEPŁYWY ─────────────────── */
.docs-alert {
  padding: 16px 20px;
  background: var(--bg-surface);
  border: 1px solid var(--rule-subtle);
  border-left: 3px solid var(--cryo-cyan);
  border-radius: var(--radius-xs);
  margin: 20px 0;
  font-size: 14px;
  line-height: 1.65;
  color: var(--text-secondary);
}

.docs-alert.amber {
  border-left-color: var(--photonic-amber);
}

.docs-alert.purple {
  border-left-color: var(--beryllium-blue);
}

.docs-alert-title {
  display: block;
  font-family: var(--font-mono);
  font-size: 12px;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-primary);
  margin-bottom: 6px;
}

.docs-flow {
  display: flex;
  flex-direction: column;
  gap: 8px;
  margin: 20px 0;
}

.docs-flow-step {
  display: flex;
  align-items: center;
  flex-wrap: wrap;
  gap: 10px;
  padding: 10px 14px;
  background: var(--bg-surface);
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-xs);
  font-size: 13px;
  color: var(--text-secondary);
}

.docs-flow-arrow {
  color: var(--cryo-cyan);
  font-weight: 700;
}

/* Odnośnik powrotu do interaktywnej wizualizacji atraktora na stronie głównej */
.docs-attractor-banner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 18px 22px;
  background: linear-gradient(90deg, var(--bg-surface) 0%, var(--bg-surface-elevated) 100%);
  border: 1px solid var(--rule-accent);
  border-radius: var(--radius-xs);
  margin: 24px 0;
  gap: 16px;
}

.docs-attractor-link {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  color: var(--cryo-cyan);
  font-family: var(--font-mono);
  font-size: 13px;
  font-weight: 700;
  text-decoration: none;
  border-bottom: 1px solid var(--cryo-cyan);
  padding-bottom: 2px;
  transition: color 0.15s ease, border-bottom-color 0.15s ease;
}

.docs-attractor-link:hover {
  color: var(--text-primary);
  border-bottom-color: var(--text-primary);
}

/* Wykres dywergencji 2D Canvas */
.docs-chart-card {
  background: var(--bg-surface);
  border: 1px solid var(--rule-subtle);
  border-radius: var(--radius-xs);
  padding: 20px;
  margin: 24px 0;
}

.docs-chart-header {
  margin-bottom: 14px;
}

.docs-chart-canvas-wrap {
  width: 100%;
  height: 340px;
  position: relative;
}

.docs-chart-canvas {
  width: 100%;
  height: 100%;
  display: block;
}

/* Lista bibliograficzna */
.docs-biblio-list {
  list-style: decimal;
  margin: 0 0 24px 28px;
  padding: 0;
  color: var(--text-secondary);
  font-size: 14px;
  line-height: 1.7;
}

.docs-biblio-list li {
  margin-bottom: 12px;
  padding-left: 4px;
}

.docs-biblio-list a {
  color: var(--cryo-cyan);
  text-decoration: none;
}

.docs-biblio-list a:hover {
  text-decoration: underline;
}

/* ── 8. RESPONSYWNOŚĆ (MEDIA QUERIES) ────────────────────────────────── */
/* Poniżej 900px: TOC zwija się w przycisk, układ staje się 1-kolumnowy */
@media (max-width: 900px) {
  .docs-grid {
    grid-template-columns: 1fr;
    gap: 32px;
  }

  .docs-toc-toggle-wrap {
    display: block;
    position: sticky;
    top: 76px;
    z-index: 80;
    margin-bottom: 16px;
    background: var(--bg-space);
    padding: 8px 0;
  }

  .docs-toc {
    display: none;
    position: static;
    width: 100%;
    max-height: 60vh;
    background: var(--bg-surface);
    border: 1px solid var(--rule-medium);
    border-radius: var(--radius-xs);
    padding: 16px;
    margin-bottom: 24px;
    box-shadow: 0 8px 24px rgba(0, 0, 0, 0.5);
  }

  .docs-toc.open {
    display: block;
  }

  .docs-body {
    max-width: 100%;
  }

  .docs-chart-canvas-wrap {
    height: 280px;
  }
}

@media (max-width: 480px) {
  .docs-hero-wrap {
    padding: 32px 0 24px;
  }

  .docs-attractor-banner {
    flex-direction: column;
    align-items: flex-start;
  }

  .docs-chart-canvas-wrap {
    height: 240px;
  }
}

/* Aliases for markup compatibility */
.table-wrap { width: 100%; overflow-x: auto; -webkit-overflow-scrolling: touch; margin: 20px 0; border: 1px solid var(--rule-subtle); border-radius: var(--radius-xs); background: var(--bg-surface); }
.table-wrap table { width: 100%; border-collapse: collapse; font-size: 13px; line-height: 1.5; text-align: left; }
.table-wrap th { background: var(--bg-surface-elevated); padding: 12px 14px; font-family: var(--font-mono); font-size: 11px; font-weight: 700; letter-spacing: 0.05em; text-transform: uppercase; color: var(--text-primary); border-bottom: 1px solid var(--rule-medium); white-space: nowrap; }
.table-wrap td { padding: 12px 14px; border-bottom: 1px solid var(--rule-subtle); color: var(--text-secondary); vertical-align: top; }
.table-wrap tr:last-child td { border-bottom: none; }
.table-wrap tr:hover td { background: rgba(255, 255, 255, 0.02); }

.grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 16px; margin: 20px 0; }
@media (max-width: 768px) { .grid { grid-template-columns: 1fr; } }
.card { background: var(--bg-surface); border: 1px solid var(--rule-subtle); padding: 20px; border-radius: var(--radius-xs); }
.card.chosen { border-color: var(--emerald-pass); background: linear-gradient(180deg, var(--emerald-pass-dim) 0%, var(--bg-surface) 100%); }
.card.rejected { border-color: rgba(255, 82, 99, 0.25); }

.badge { display: inline-block; font-family: var(--font-mono); font-size: 10px; font-weight: 700; padding: 2px 6px; border-radius: var(--radius-xs); margin-bottom: 10px; text-transform: uppercase; letter-spacing: 0.05em; }
.badge.ok { background: var(--emerald-pass); color: #05070a; }
.badge.no { background: rgba(255, 82, 99, 0.2); color: var(--cadmium-crimson); border: 1px solid rgba(255, 82, 99, 0.3); }

.alert { padding: 16px 20px; background: var(--bg-surface); border: 1px solid var(--rule-subtle); border-left: 3px solid var(--cryo-cyan); border-radius: var(--radius-xs); margin: 20px 0; font-size: 14px; line-height: 1.65; color: var(--text-secondary); }
/* Tylko PIERWSZY <strong> w ramce jest jej naglowkiem. Regula bez :first-child
   lamala kazde wyroznienie w srodku zdania na osobna linie (np. "6 GB"). */
.alert > strong:first-child { color: var(--text-primary); display: block; margin-bottom: 4px; font-family: var(--font-mono); font-size: 12px; text-transform: uppercase; letter-spacing: 0.05em; }
.alert strong { color: var(--text-primary); }

.flow { display: flex; flex-direction: column; gap: 8px; margin: 20px 0; }
.flow-step { display: flex; align-items: center; flex-wrap: wrap; gap: 10px; padding: 10px 14px; background: var(--bg-surface); border: 1px solid var(--rule-subtle); border-radius: var(--radius-xs); font-size: 13px; color: var(--text-secondary); }
.flow-step .mod { font-family: var(--font-mono); color: var(--cryo-cyan); font-weight: 600; }
.flow-step .arrow { color: var(--cryo-cyan); font-weight: 700; }
.flow-step .nm { font-family: var(--font-mono); color: var(--photonic-amber); font-weight: 700; }

.ref-list { list-style: decimal; margin: 0 0 24px 28px; padding: 0; color: var(--text-secondary); font-size: 14px; line-height: 1.7; }
.ref-list li { margin-bottom: 12px; padding-left: 4px; }
/* Adnotacja "gdzie uzyte" przy pozycji bibliografii. Bibliografia ma byc mapa
   powiazan teoria->mechanizm, a nie sama lista tytulow — dlatego kazda pozycja
   niesie wskazanie rozdzialu w osobnej, stonowanej linii. */
.ref-list .ref-use { display: block; margin-top: 3px; color: var(--text-muted); font-size: 13px; line-height: 1.55; }
.docs-section .ref-list + h3 { margin-top: 28px; }

/* Kotwice sekcji chowaly sie pod przyklejonym mastheadem przy skoku z TOC —
   naglowek rozdzialu byl ucinany od gory. */
.docs-body section[id] { scroll-margin-top: 96px; }