/* ============================================================================
   NeonDAW — documentation styles. Layered on top of css/neon.css: same tokens,
   same components, plus a docs layout (sticky chapter sidebar + reading column).
   ========================================================================== */

/* ---------------------------------------------------------------- layout -- */
.docs {
  padding-block: clamp(36px, 5vw, 64px) clamp(48px, 7vw, 88px);
}

.docs__grid {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr);
  gap: clamp(36px, 5vw, 72px);
  align-items: start;
}

/* active nav link (the Docs tab) */
.nav__links a.is-active {
  color: var(--text);
}

/* --------------------------------------------------- language switch -- */
.lang-switch {
  position: relative;
  margin-bottom: 18px;
}

.lang-switch__btn {
  display: flex;
  align-items: center;
  gap: 9px;
  width: 100%;
  padding: 10px 13px;
  border: 1px solid var(--stroke);
  border-radius: 12px;
  background: var(--panel);
  color: var(--text);
  font-size: 0.92rem;
  font-weight: 600;
  cursor: pointer;
  list-style: none;
  user-select: none;
  transition: border-color 0.18s ease, background 0.18s ease;
}

.lang-switch__btn::-webkit-details-marker {
  display: none;
}

.lang-switch__btn:hover {
  border-color: color-mix(in srgb, var(--cyan) 45%, transparent);
  background: var(--panel-hi);
}

.lang-switch__btn > svg:first-child {
  width: 17px;
  height: 17px;
  flex: none;
  color: var(--cyan);
}

.lang-switch__name {
  flex: 1;
  text-align: left;
}

.lang-switch__chev {
  width: 15px;
  height: 15px;
  flex: none;
  color: var(--dim);
  transition: transform 0.22s ease;
}

.lang-switch[open] .lang-switch__chev {
  transform: rotate(180deg);
}

/* in-flow (not absolute): opening it pushes the chapter list down and scrolls
   with the sidebar, so the sidebar's overflow-y can never clip it */
.lang-switch__menu {
  margin-top: 6px;
  max-height: 340px;
  overflow-y: auto;
  overscroll-behavior: contain;
  padding: 6px;
  display: flex;
  flex-direction: column;
  gap: 1px;
  border: 1px solid var(--stroke);
  border-radius: 12px;
  background: rgba(8, 10, 20, 0.55);
}

.lang-switch__menu a {
  display: block;
  padding: 8px 12px;
  border-radius: 8px;
  color: var(--text-2);
  font-size: 0.92rem;
  border-left: 0;
  transition: color 0.15s ease, background 0.15s ease;
}

.lang-switch__menu a:hover {
  color: #fff;
  background: rgba(255, 255, 255, 0.05);
}

.lang-switch__menu a.is-current {
  color: var(--cyan);
  font-weight: 600;
  background: color-mix(in srgb, var(--cyan) 10%, transparent);
}

/* on the docs home there is no sidebar: sit the switcher above the head, right-aligned */
.lang-switch--home {
  max-width: 240px;
  margin-left: auto;
  margin-bottom: 22px;
}

/* --------------------------------------------------------------- sidebar -- */
.docs-side {
  position: sticky;
  top: 86px;
  max-height: calc(100vh - 106px);
  overflow-y: auto;
  overscroll-behavior: contain;
  scrollbar-width: thin;
  padding-bottom: 12px;
}

/* the <details> wrapper only behaves like a disclosure on mobile; on desktop
   the summary is hidden and js/docs.js keeps it open */
.docs-side__toggle {
  display: none;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  font-family: var(--mono);
  font-size: 12px;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text);
  padding: 13px 16px;
  border: 1px solid var(--stroke);
  border-radius: 12px;
  background: var(--panel);
  cursor: pointer;
  list-style: none;
  user-select: none;
}

.docs-side__toggle::-webkit-details-marker {
  display: none;
}

.docs-side__toggle svg {
  width: 16px;
  height: 16px;
  flex: none;
  transition: transform 0.25s ease;
}

.docs-side__wrap[open] .docs-side__toggle svg {
  transform: rotate(180deg);
}

.docs-toc__home {
  display: block;
  font-family: var(--mono);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--cyan);
  padding: 6px 10px 6px 0;
  margin-bottom: 4px;
}

.docs-toc__home:hover {
  color: #fff;
}

.docs-toc__group {
  font-family: var(--mono);
  font-size: 9.5px;
  font-weight: 700;
  letter-spacing: 0.22em;
  text-transform: uppercase;
  color: var(--faint);
  margin: 20px 0 6px;
}

.docs-toc a:not(.docs-toc__home) {
  display: block;
  font-size: 0.92rem;
  color: var(--dim);
  padding: 5px 12px;
  border-left: 1px solid var(--stroke);
  border-radius: 0 8px 8px 0;
  transition: color 0.18s ease, background 0.18s ease, border-color 0.18s ease;
}

.docs-toc a:not(.docs-toc__home):hover {
  color: var(--text);
  background: rgba(255, 255, 255, 0.03);
}

.docs-toc a.is-here {
  color: #fff;
  font-weight: 600;
  border-left: 2px solid var(--cyan);
  padding-left: 11px;
  background: linear-gradient(90deg, rgba(51, 242, 255, 0.1), transparent 80%);
}

/* --------------------------------------------------------- reading column -- */
.docs-main {
  max-width: 800px;
  min-width: 0;
}

.docs-main .eyebrow {
  margin-bottom: 16px;
}

.docs-main h1 {
  font-size: clamp(2rem, 4.5vw, 2.9rem);
  margin-bottom: 14px;
}

.docs-lede {
  font-size: 1.1rem;
  color: var(--text-2);
  max-width: 62ch;
  margin-bottom: 10px;
}

.docs-main h2 {
  font-size: 1.42rem;
  color: #fff;
  margin: 44px 0 14px;
  padding-top: 30px;
  border-top: 1px solid var(--stroke-2);
}

.docs-main h3 {
  font-size: 1.08rem;
  color: var(--text);
  margin: 28px 0 10px;
}

.docs-main h4 {
  font-family: var(--mono);
  font-size: 10.5px;
  font-weight: 700;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--dim);
  margin: 24px 0 8px;
}

.docs-main [id] {
  scroll-margin-top: 92px;
}

.docs-main p,
.docs-main li {
  color: var(--text-2);
  font-size: 1rem;
  line-height: 1.75;
}

.docs-main p {
  margin-bottom: 14px;
}

.docs-main ul,
.docs-main ol {
  margin: 0 0 18px;
  padding-left: 22px;
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.docs-main li::marker {
  color: var(--cyan);
}

.docs-main strong {
  color: var(--text);
}

.docs-main a {
  color: var(--cyan);
  border-bottom: 1px solid rgba(51, 242, 255, 0.3);
  transition: border-color 0.18s ease;
}

.docs-main a:hover {
  border-bottom-color: var(--cyan);
}

.docs-main figure.shot {
  margin: 26px 0;
}

/* keys & inline code */
kbd {
  font-family: var(--mono);
  font-size: 0.78em;
  font-weight: 600;
  color: var(--text);
  background: var(--panel-hi);
  border: 1px solid var(--stroke);
  border-radius: 6px;
  padding: 2px 7px;
  white-space: nowrap;
  box-shadow: inset 0 -2px 0 rgba(0, 0, 0, 0.35);
}

.docs-main code {
  font-family: var(--mono);
  font-size: 0.85em;
  color: var(--ice);
  background: rgba(255, 255, 255, 0.05);
  border: 1px solid var(--stroke-2);
  border-radius: 6px;
  padding: 1px 6px;
}

/* ------------------------------------------------------------ code blocks -- */
.codeblock {
  margin: 16px 0 18px;
  padding: 14px 18px;
  border-radius: var(--radius-sm);
  border: 1px solid var(--stroke);
  background: #06080f;
  overflow-x: auto;
}

.codeblock,
.codeblock code {
  font-family: var(--mono);
  font-size: 0.86rem;
  line-height: 1.65;
  color: var(--ice);
  white-space: pre;
}

.docs-main .codeblock code {
  background: none;
  border: 0;
  padding: 0;
}

/* -------------------------------------------------------------- callouts -- */
.callout {
  --tint: var(--cyan);
  margin: 22px 0;
  padding: 15px 18px 13px;
  border-radius: var(--radius-sm);
  border: 1px solid color-mix(in srgb, var(--tint) 30%, transparent);
  background: color-mix(in srgb, var(--tint) 6%, transparent);
}

.callout--tip {
  --tint: var(--lime);
}

.callout--warn {
  --tint: var(--amber);
}

.callout__label {
  display: block;
  font-family: var(--mono);
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.2em;
  text-transform: uppercase;
  color: var(--tint);
  margin-bottom: 6px;
}

.callout p {
  margin: 0;
  font-size: 0.96rem;
}

.callout p + p {
  margin-top: 8px;
}

/* ---------------------------------------------------------------- tables -- */
.tablewrap {
  overflow-x: auto;
  margin: 20px 0;
  border: 1px solid var(--stroke);
  border-radius: var(--radius-sm);
}

.docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.95rem;
  min-width: 460px;
}

.docs-table th {
  font-family: var(--mono);
  font-size: 10px;
  font-weight: 700;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  text-align: left;
  color: var(--dim);
  padding: 12px 16px;
  background: rgba(255, 255, 255, 0.03);
  border-bottom: 1px solid var(--stroke);
}

.docs-table td {
  padding: 10px 16px;
  border-bottom: 1px solid var(--stroke-2);
  color: var(--text-2);
  vertical-align: top;
  line-height: 1.55;
}

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

.docs-table td:first-child {
  white-space: nowrap;
}

/* ------------------------------------------------------- on-page jump row -- */
.docs-jump {
  display: flex;
  flex-wrap: wrap;
  gap: 8px;
  margin: 20px 0 6px;
}

.docs-jump a {
  font-family: var(--mono);
  font-size: 10px;
  font-weight: 600;
  letter-spacing: 0.06em;
  text-transform: uppercase;
  color: var(--text-2);
  padding: 5px 10px;
  border-radius: 7px;
  border: 1px solid var(--stroke);
  background: rgba(255, 255, 255, 0.025);
  transition: color 0.18s ease, border-color 0.18s ease;
}

.docs-jump a:hover {
  color: var(--cyan);
  border-color: color-mix(in srgb, var(--cyan) 45%, transparent);
}

/* --------------------------------------------------------- prev/next pager */
.docs-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 14px;
  margin-top: clamp(48px, 7vw, 72px);
}

.docs-pager a {
  display: flex;
  flex-direction: column;
  gap: 6px;
  padding: 16px 18px;
  border-radius: var(--radius-sm);
  border: 1px solid var(--stroke);
  background: rgba(255, 255, 255, 0.02);
  transition: border-color 0.2s ease, transform 0.2s ease;
}

.docs-pager a:hover {
  border-color: rgba(51, 242, 255, 0.45);
  transform: translateY(-2px);
}

.docs-pager__dir {
  font-family: var(--mono);
  font-size: 9.5px;
  font-weight: 700;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--dim);
}

.docs-pager__title {
  font-weight: 700;
  color: var(--text);
  font-size: 0.98rem;
}

.docs-pager--next {
  grid-column: 2;
  text-align: right;
  align-items: flex-end;
}

.docs-pager--prev {
  grid-column: 1;
}

/* -------------------------------------------------------------- docs home -- */
.doc-quick {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 18px;
  margin-bottom: clamp(36px, 5vw, 56px);
}

.doc-groups {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 18px;
}

.doc-group {
  padding: 22px 22px 18px;
  border-radius: 16px;
}

.doc-group h3 {
  font-family: var(--mono);
  font-size: 10.5px;
  font-weight: 700;
  letter-spacing: 0.2em;
  text-transform: uppercase;
  color: var(--tint, var(--cyan));
  margin-bottom: 12px;
}

.doc-group a {
  display: block;
  color: var(--text-2);
  font-size: 0.95rem;
  padding: 5px 0;
  transition: color 0.18s ease, transform 0.18s ease;
}

.doc-group a:hover {
  color: var(--cyan);
  transform: translateX(2px);
}

/* ------------------------------------------------------------ responsive -- */
@media (max-width: 940px) {
  .docs__grid {
    grid-template-columns: 1fr;
    gap: 24px;
  }

  .docs-side {
    position: static;
    max-height: none;
    overflow: visible;
    padding-bottom: 0;
  }

  .docs-side__toggle {
    display: flex;
  }

  .docs-side__wrap[open] .docs-toc {
    margin-top: 8px;
    padding: 10px 14px 14px;
    border: 1px solid var(--stroke-2);
    border-radius: 12px;
    background: rgba(8, 10, 20, 0.55);
  }

  .doc-quick,
  .doc-groups {
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (max-width: 560px) {
  .doc-quick,
  .doc-groups {
    grid-template-columns: 1fr;
  }

  .docs-pager {
    grid-template-columns: 1fr;
  }

  .docs-pager--next,
  .docs-pager--prev {
    grid-column: auto;
    text-align: left;
    align-items: flex-start;
  }
}