/* Sub Control docs — sidebar + article layout (subcontrol/docs/**) */

.docs-layout {
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  gap: clamp(32px, 5vw, 72px);
  align-items: start;
}

/* ---- sidebar ---- */

.docs-side {
  position: sticky;
  top: calc(var(--bar-h, 0px) + var(--nav-h, 64px) + var(--s5));
  display: grid;
  gap: var(--s3);
}

.docs-side .dl-back { margin-bottom: var(--s3); }

.docs-side-k {
  color: var(--faint);
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: .12em;
  text-transform: uppercase;
}

.docs-side-other { margin-top: var(--s4); }

.docs-nav {
  list-style: none;
  margin: 0;
  padding: 0;
  display: grid;
  border-left: 1px solid var(--hairline);
}

.docs-nav a {
  display: block;
  padding: 7px var(--s3);
  margin-left: -1px;
  border-left: 1px solid transparent;
  color: var(--dim);
  font-size: 14px;
  text-decoration: none;
}

.docs-nav a:hover, .docs-nav a:focus-visible {
  color: var(--fg);
  border-left-color: var(--stroke-2);
}

.docs-nav a[aria-current="page"] {
  color: var(--accent);
  border-left-color: var(--accent-line);
  background: var(--accent-wash);
}

/* ---- article ---- */

.doc-article { max-width: var(--content-narrow); min-width: 0; }

.doc-article .kick { margin-bottom: var(--s4); }
.doc-article .display-2 { margin-bottom: var(--s4); }
.doc-article .lede { margin-bottom: clamp(28px, 4.5vh, 44px); }

.doc-article p {
  color: var(--dim);
  line-height: 1.65;
  margin-bottom: var(--s4);
  max-width: 66ch;
}

.doc-article h2 {
  color: var(--fg);
  font-size: 21px;
  font-weight: 600;
  letter-spacing: -.012em;
  margin: clamp(28px, 4.5vh, 44px) 0 var(--s3);
  padding-top: var(--s5);
  border-top: 1px solid var(--hairline);
  scroll-margin-top: calc(var(--bar-h, 0px) + var(--nav-h, 64px) + var(--s5));
}

.doc-article h3 {
  color: var(--fg);
  font-size: 16px;
  font-weight: 600;
  margin: var(--s8) 0 var(--s2);
  scroll-margin-top: calc(var(--bar-h, 0px) + var(--nav-h, 64px) + var(--s5));
}

.doc-article ul {
  color: var(--dim);
  line-height: 1.65;
  margin: 0 0 var(--s4);
  padding-left: 1.2em;
  max-width: 66ch;
}

.doc-article li { margin-bottom: var(--s1); }

.doc-code {
  background: var(--glass-well);
  border: 1px solid var(--stroke);
  border-radius: var(--r-3);
  padding: var(--s4) var(--s5);
  margin: 0 0 var(--s4);
  overflow-x: auto;
}

.doc-code code {
  font-family: var(--mono);
  font-size: 12.5px;
  line-height: 1.7;
  color: var(--fg);
  white-space: pre;
}

/* ---- article toolbar (view switch + copy) ---- */

/* The toolbar only does anything with JS; hide it when scripts are off. */
.doc-toolbar { display: none; }

.js .doc-toolbar {
  display: flex;
  align-items: center;
  gap: var(--s3);
  margin-bottom: clamp(24px, 4vh, 36px);
  padding: var(--s2);
  border: 1px solid var(--stroke);
  border-radius: var(--r-3);
  background: var(--glass-well);
}

.doc-view {
  display: inline-flex;
  padding: 2px;
  border: 1px solid var(--stroke);
  border-radius: var(--r-2);
}

.doc-view-btn {
  appearance: none;
  border: 0;
  background: none;
  padding: 5px 12px;
  border-radius: calc(var(--r-2) - 2px);
  color: var(--dim);
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: .06em;
  text-transform: uppercase;
  cursor: pointer;
}

.doc-view-btn:hover, .doc-view-btn:focus-visible { color: var(--fg); }

.doc-view-btn[aria-pressed="true"] {
  color: var(--accent);
  background: var(--accent-wash);
  box-shadow: inset 0 0 0 1px var(--accent-line);
}

.doc-toolbar-meta {
  margin-left: auto;
  color: var(--faint);
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: .08em;
  text-transform: uppercase;
  white-space: nowrap;
}

.doc-copy {
  appearance: none;
  background: none;
  border: 1px solid var(--stroke);
  border-radius: var(--r-2);
  padding: 6px 12px;
  color: var(--dim);
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: .06em;
  text-transform: uppercase;
  cursor: pointer;
  white-space: nowrap;
}

.doc-copy:hover, .doc-copy:focus-visible {
  color: var(--fg);
  border-color: var(--stroke-2);
}

.doc-copy.is-ok {
  color: var(--accent);
  border-color: var(--accent-line);
  background: var(--accent-wash);
}

/* ---- raw view ---- */

.doc-raw {
  background: var(--glass-well);
  border: 1px solid var(--stroke);
  border-radius: var(--r-3);
  padding: var(--s4) var(--s5);
  margin: 0 0 var(--s4);
  overflow-x: auto;
}

.doc-raw code {
  font-family: var(--mono);
  font-size: 12.5px;
  line-height: 1.7;
  color: var(--dim);
  white-space: pre;
}

@media (max-width: 560px) {
  .js .doc-toolbar { flex-wrap: wrap; }
  .doc-toolbar-meta { display: none; }
}

/* ---- prev / next pager ---- */

.doc-pager {
  display: flex;
  justify-content: space-between;
  gap: var(--s4);
  margin-top: clamp(36px, 6vh, 64px);
  padding-top: var(--s5);
  border-top: 1px solid var(--hairline);
}

.doc-pager a {
  display: grid;
  gap: 2px;
  text-decoration: none;
  color: var(--fg);
  font-size: 15px;
  font-weight: 600;
  letter-spacing: -.008em;
}

.doc-pager a:hover span:last-child,
.doc-pager a:focus-visible span:last-child { color: var(--accent); }

.doc-next { text-align: right; }

.doc-pager-k {
  color: var(--faint);
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: .04em;
  font-weight: 400;
}

/* ---- mobile ---- */

@media (max-width: 820px) {
  .docs-layout { grid-template-columns: 1fr; }

  .docs-side {
    position: static;
    padding-bottom: var(--s5);
    border-bottom: 1px solid var(--hairline);
  }
}