/* ==========================================================================
   docs.css — CrazyToad documentation layer.
   Loaded AFTER /index.css on every /docs/ page. Colors come only from the
   theme CSS variables (--text, --text-2, --accent, --elevated, --border, …)
   so the whole docs section recolors with the 50-theme system. No hardcoded
   colors — everything must survive a live theme swap.
   ========================================================================== */

/* --- Shell: sidebar / main / on-this-page rail ---------------------------- */
.docs-page .docs-shell {
  max-width: 1400px;
  margin: 0 auto;
  /* Clear the 64px fixed nav: without this the crumbs (desktop) and the mobile
     "Docs menu" disclosure button render *under* the bar — on mobile the button
     was fully obscured and un-tappable (it's the only route to the sidebar nav). */
  padding: calc(64px + clamp(1rem, 2.5vw, 1.6rem)) clamp(1.1rem, 4vw, 2.4rem) 4rem;
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 200px;
  gap: clamp(1.6rem, 3vw, 2.8rem);
  align-items: start;
}

/* --- Left sidebar --------------------------------------------------------- */
.docs-side {
  position: sticky;
  top: 84px;
  align-self: start;
}
.docs-menu-btn {
  display: none;
  width: 100%;
  font-family: var(--fm);
  font-size: .8rem;
  letter-spacing: .06em;
  text-transform: uppercase;
  color: var(--text);
  background: var(--elevated);
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  padding: .7rem 1rem;
  cursor: pointer;
}
.docs-menu-btn::after { content: ' ▾'; color: var(--accent-readable); }
.docs-side.is-open .docs-menu-btn::after { content: ' ▴'; }
.docs-side-inner {
  max-height: calc(100vh - 108px);
  overflow-y: auto;
  padding-right: .4rem;
}
.docs-tree { display: flex; flex-direction: column; gap: 1.3rem; }
.docs-cat-h {
  font-family: var(--fm);
  font-size: .7rem;
  font-weight: 700;
  letter-spacing: .12em;
  text-transform: uppercase;
  color: var(--muted);
  margin: 0 0 .55rem;
  padding-left: .2rem;
}
.docs-tree ul { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 1px; }
.docs-tree a {
  display: block;
  color: var(--text-2);
  text-decoration: none;
  font-size: .9rem;
  line-height: 1.35;
  padding: .42rem .7rem;
  border-radius: var(--r-sm);
  border-left: 2px solid transparent;
  transition: color .15s, background .15s, border-color .15s;
}
.docs-tree a:hover { color: var(--text); background: rgb(var(--accent-rgb) / 0.06); }
.docs-tree a.active {
  color: var(--accent-readable);
  background: rgb(var(--accent-rgb) / 0.1);
  border-left-color: var(--accent);
  font-weight: 600;
}

/* --- Main column ---------------------------------------------------------- */
.docs-main { min-width: 0; }
.docs-crumbs {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: .5rem;
  font-family: var(--fm);
  font-size: .74rem;
  letter-spacing: .04em;
  color: var(--muted);
  margin-bottom: 1.4rem;
}
.docs-crumbs a { color: var(--text-2); text-decoration: none; }
.docs-crumbs a:hover { color: var(--accent-readable); }
.docs-crumbs .sep { color: var(--border); }
.docs-crumbs b { color: var(--text); font-weight: 600; }

/* --- Article typography --------------------------------------------------- */
.docs-article { max-width: 46rem; }
.docs-article > .docs-kicker {
  display: inline-block;
  font-family: var(--fm);
  font-size: .72rem;
  letter-spacing: .14em;
  text-transform: uppercase;
  color: var(--accent-readable);
  margin-bottom: .7rem;
}
.docs-article h1 {
  font-size: clamp(1.9rem, 4vw, 2.7rem);
  line-height: 1.05;
  margin: 0 0 1rem;
  color: var(--text);
}
.docs-article .lede {
  font-size: 1.08rem;
  line-height: 1.6;
  color: var(--text-2);
  margin: 0 0 1.6rem;
}
.docs-article h2 {
  font-size: 1.35rem;
  line-height: 1.25;
  color: var(--text);
  margin: 2.6rem 0 .9rem;
  padding-top: .4rem;
  scroll-margin-top: 90px;
}
.docs-article h3 {
  font-size: 1.05rem;
  color: var(--text);
  margin: 1.8rem 0 .6rem;
  scroll-margin-top: 90px;
}
.docs-article p { color: var(--text-2); line-height: 1.7; margin: 0 0 1rem; }
.docs-article ul, .docs-article ol { color: var(--text-2); line-height: 1.7; margin: 0 0 1rem; padding-left: 1.3rem; }
.docs-article li { margin: .3rem 0; }
.docs-article li b, .docs-article p b { color: var(--text); }
/* :not(.btn) — buttons inside articles keep .btn-primary's --accent-contrast
   text; without it this rule painted accent-on-accent (unreadable, all themes). */
.docs-article a:not(.btn) { color: var(--accent-readable); text-decoration: none; border-bottom: 1px solid rgb(var(--accent-rgb) / 0.28); }
.docs-article a:not(.btn):hover { border-bottom-color: var(--accent); }
.docs-article code {
  font-family: var(--fm);
  background: var(--void);
  color: var(--accent-readable);
  padding: 1px 6px;
  border-radius: 6px;
  font-size: .84em;
  overflow-wrap: anywhere;
}
.docs-article .frame { margin: 1.4rem 0; }
.docs-article .docs-shot-note {
  font-family: var(--fm);
  font-size: .74rem;
  color: var(--muted);
  margin: -.7rem 0 1.6rem;
}
.docs-article .guide-mini-grid { margin: 1.2rem 0 1.6rem; }
.docs-article .guide-mini-grid + .docs-callout { margin-top: 0; }

/* --- "At a glance" box ---------------------------------------------------- */
.docs-glance {
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  background: var(--elevated);
  padding: 1.1rem 1.3rem;
  margin: 0 0 1.8rem;
}
.docs-glance h2 {
  font-family: var(--fm);
  font-size: .72rem !important;
  letter-spacing: .12em;
  text-transform: uppercase;
  color: var(--muted);
  margin: 0 0 .7rem !important;
  padding: 0 !important;
}
.docs-glance ul { margin: 0; padding-left: 1.1rem; }
.docs-glance li { color: var(--text-2); }

/* --- Callouts (tip / note / warn) ----------------------------------------- */
.docs-callout {
  display: flex;
  gap: .8rem;
  border: 1px solid var(--border);
  border-left: 3px solid var(--accent);
  border-radius: var(--r-sm);
  background: rgb(var(--accent-rgb) / 0.05);
  padding: .95rem 1.15rem;
  margin: 1.4rem 0;
  color: var(--text-2);
  font-size: .92rem;
  line-height: 1.6;
}
.docs-callout b { color: var(--text); }
.docs-callout code { background: var(--void); }
.docs-callout .docs-callout-ico {
  flex: 0 0 auto;
  font-family: var(--fm);
  font-size: .68rem;
  font-weight: 700;
  letter-spacing: .08em;
  text-transform: uppercase;
  color: var(--accent-readable);
  padding-top: .1rem;
}
.docs-callout--note { border-left-color: var(--text-2); background: rgb(var(--void-rgb) / 0.3); }
.docs-callout--note .docs-callout-ico { color: var(--text-2); }
.docs-callout--warn { border-left-color: var(--gold); background: rgb(var(--accent-rgb) / 0.04); }
.docs-callout--warn .docs-callout-ico { color: var(--gold-readable); }

/* --- Related block -------------------------------------------------------- */
.docs-related {
  margin: 2.6rem 0 0;
  padding-top: 1.6rem;
  border-top: 1px solid var(--border-soft);
}
.docs-related-h {
  font-family: var(--fm);
  font-size: .72rem;
  letter-spacing: .12em;
  text-transform: uppercase;
  color: var(--muted);
  margin-bottom: .8rem;
}
.docs-related ul { list-style: none; margin: 0; padding: 0; display: flex; flex-wrap: wrap; gap: .6rem; }
.docs-related a {
  display: inline-block;
  font-size: .86rem;
  color: var(--text-2);
  text-decoration: none;
  border: 1px solid var(--border);
  border-radius: 999px;
  padding: .4rem .9rem;
  transition: color .15s, border-color .15s;
}
.docs-related a:hover { color: var(--accent-readable); border-color: var(--accent); }

/* --- Prev / next ---------------------------------------------------------- */
.docs-pagenav {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
  margin: 2.4rem 0 0;
}
.docs-pagenav a {
  display: flex;
  flex-direction: column;
  gap: .25rem;
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  background: var(--elevated);
  padding: .9rem 1.1rem;
  text-decoration: none;
  transition: border-color .15s, transform .15s;
}
.docs-pagenav a:hover { border-color: var(--accent); transform: translateY(-2px); }
.docs-pagenav a.docs-next { text-align: right; align-items: flex-end; }
.docs-pagenav span {
  font-family: var(--fm);
  font-size: .68rem;
  letter-spacing: .1em;
  text-transform: uppercase;
  color: var(--muted);
}
.docs-pagenav b { color: var(--accent-readable); font-size: .96rem; }
.docs-pagenav .docs-pagenav-empty { border: 1px dashed var(--border-soft); background: transparent; pointer-events: none; }

/* --- On-this-page rail ---------------------------------------------------- */
.docs-toc {
  position: sticky;
  top: 84px;
  align-self: start;
  font-size: .84rem;
}
.docs-toc-h {
  font-family: var(--fm);
  font-size: .68rem;
  letter-spacing: .12em;
  text-transform: uppercase;
  color: var(--muted);
  margin-bottom: .7rem;
}
.docs-toc ul { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: 1px; border-left: 1px solid var(--border); }
.docs-toc a {
  display: block;
  color: var(--text-2);
  text-decoration: none;
  padding: .3rem .8rem;
  margin-left: -1px;
  border-left: 2px solid transparent;
  line-height: 1.35;
}
.docs-toc a:hover { color: var(--text); }
.docs-toc a.active { color: var(--accent-readable); border-left-color: var(--accent); }

/* --- Docs home (hub) ------------------------------------------------------ */
.docs-home-hero { margin: 0 0 2.4rem; }
.docs-home-hero .docs-kicker { color: var(--accent-readable); }
.docs-home-hero h1 { font-size: clamp(2rem, 5vw, 3rem); line-height: 1.03; color: var(--text); margin: .6rem 0 1rem; }
.docs-home-hero .lede { font-size: 1.12rem; color: var(--text-2); line-height: 1.6; max-width: 44rem; }
.docs-cat-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(230px, 1fr));
  gap: 1rem;
  margin: 1.2rem 0 2.4rem;
}
.docs-cat-card {
  display: block;
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  background: var(--elevated);
  padding: 1.2rem 1.3rem;
  text-decoration: none;
  transition: border-color .15s, transform .15s;
}
.docs-cat-card:hover { border-color: var(--accent); transform: translateY(-3px); }
.docs-cat-card h3 { color: var(--text); margin: 0 0 .4rem; font-size: 1.05rem; }
.docs-cat-card p { color: var(--text-2); margin: 0; font-size: .88rem; line-height: 1.55; }
.docs-popular {
  display: flex;
  flex-wrap: wrap;
  gap: .6rem;
  margin: .6rem 0 2.4rem;
}
.docs-popular a {
  font-size: .88rem;
  color: var(--text-2);
  text-decoration: none;
  border: 1px solid var(--border);
  border-radius: 999px;
  padding: .45rem 1rem;
  transition: color .15s, border-color .15s;
}
.docs-popular a:hover { color: var(--accent-readable); border-color: var(--accent); }
.docs-cta {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: 1rem;
  border: 1px solid var(--border);
  border-radius: var(--r-sm);
  background: linear-gradient(180deg, transparent, rgb(var(--accent-rgb) / 0.05));
  padding: 1.5rem 1.6rem;
  margin: 1rem 0 0;
}
.docs-cta p { margin: 0; color: var(--text-2); flex: 1 1 16rem; }
.docs-cta b { color: var(--text); }

/* --- Responsive ----------------------------------------------------------- */
@media (max-width: 1100px) {
  .docs-page .docs-shell { grid-template-columns: 240px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 900px) {
  .docs-page .docs-shell { grid-template-columns: 1fr; gap: 1.2rem; }
  .docs-side { position: static; top: 0; }
  .docs-menu-btn { display: block; }
  .docs-side-inner {
    display: none;
    max-height: none;
    margin-top: .7rem;
    border: 1px solid var(--border);
    border-radius: var(--r-sm);
    padding: 1rem;
    background: var(--elevated);
  }
  .docs-side.is-open .docs-side-inner { display: block; }
  .docs-article { max-width: none; }
}
@media (max-width: 560px) {
  .docs-pagenav { grid-template-columns: 1fr; }
}