/* docs.css — documentation page (sidebar + content + right rail) */

html { scroll-padding-top: 70px; }
body { line-height: 1.6; }

/* Layout */
.shell { max-width: 1320px; margin: 0 auto; display: grid; grid-template-columns: 264px minmax(0, 1fr) 220px; gap: 0; }

/* Sidebar */
.sidebar {
  position: sticky; top: 52px; align-self: start; height: calc(100vh - 52px);
  overflow-y: auto; overflow-x: hidden; padding: 2rem 1.2rem 4rem; border-right: 1px solid var(--border);
}
.side-group { margin-bottom: 1.6rem; }
.side-group h4 { font-size: .74rem; text-transform: uppercase; letter-spacing: .06em; color: var(--text-2); margin: 0 0 .6rem .6rem; font-weight: 600; }
.side-group a { display: block; color: var(--text-2); font-size: .9rem; padding: .34rem .6rem; border-radius: 7px; line-height: 1.3; }
.side-group a:hover { color: var(--text); background: var(--bg-2); text-decoration: none; }
.side-group a.active { color: var(--accent); background: var(--side-active); font-weight: 500; }

/* Sidebar search */
.doc-search {
  width: 100%; max-width: 100%; margin-bottom: 1.5rem; padding: .5rem .75rem; font: inherit; font-size: .9rem;
  color: var(--text); background: var(--bg-2); border: 1px solid var(--border); border-radius: 9px;
  -webkit-appearance: none; appearance: none;
}
.doc-search::placeholder { color: var(--text-2); }
.doc-search:focus, .doc-search:focus-visible { outline: 2px solid var(--accent); outline-offset: 1px; }
.side-empty { color: var(--text-2); font-size: .85rem; padding: .3rem .6rem; display: none; }

/* "On this page" right rail */
.onthispage { position: sticky; top: 52px; align-self: start; height: calc(100vh - 52px); overflow-y: auto; padding: 2.6rem 1.1rem 4rem; }
.onthispage h4 { font-size: .72rem; text-transform: uppercase; letter-spacing: .06em; color: var(--text-2); font-weight: 600; margin-bottom: .8rem; }
.onthispage nav { display: flex; flex-direction: column; border-left: 1px solid var(--border); position: static; background: none; backdrop-filter: none; border-bottom: none; }
.onthispage a { font-size: .83rem; color: var(--text-2); padding: .32rem .8rem; margin-left: -1px; line-height: 1.35; border-left: 2px solid transparent; }
.onthispage a:hover { color: var(--text); text-decoration: none; }
.onthispage a.active { color: var(--accent); border-left-color: var(--accent); font-weight: 500; }

/* Content */
main { padding: 2.6rem clamp(1.2rem, 4vw, 3.5rem) 6rem; max-width: 860px; }
.crumb { font-size: .82rem; color: var(--text-2); margin-bottom: .8rem; }
main h1 { font-size: clamp(2rem, 5vw, 2.9rem); letter-spacing: -0.02em; line-height: 1.08; margin-bottom: .6rem; }
.subtitle { font-size: 1.15rem; color: var(--text-2); margin-bottom: 1.6rem; }
main h2 { font-size: 1.7rem; letter-spacing: -0.015em; margin: 3.2rem 0 1rem; padding-top: .4rem; scroll-margin-top: 68px; }
main h2:first-of-type { margin-top: 1.5rem; }
main h3 { font-size: 1.2rem; margin: 2rem 0 .7rem; scroll-margin-top: 68px; }
main p, main li { color: #3a3a3c; }
[data-theme="dark"] main p, [data-theme="dark"] main li { color: #d0d0d3; }
main p { margin: 0 0 1rem; }
main ul, main ol { margin: 0 0 1rem 1.3rem; }
main li { margin: .3rem 0; }
.lead { font-size: 1.05rem; }

/* Callout */
.callout { display: flex; gap: .9rem; align-items: flex-start; background: var(--bg-2); border: 1px solid var(--border); border-radius: 12px; padding: 1rem 1.2rem; margin: 1.4rem 0; font-size: .95rem; }
.callout.gh { align-items: center; justify-content: space-between; flex-wrap: wrap; }
.callout .btn-sm { display: inline-flex; align-items: center; gap: .4rem; background: var(--accent); color: var(--on-accent); padding: .5rem 1rem; border-radius: 980px; font-size: .88rem; font-weight: 500; white-space: nowrap; }
.callout .btn-sm:hover { background: var(--accent-hover); text-decoration: none; }

/* Table */
.table-wrap { overflow-x: auto; margin: 1rem 0; }
table { border-collapse: collapse; width: 100%; font-size: .9rem; }
th, td { text-align: left; padding: .6em .9em; border-bottom: 1px solid var(--border); vertical-align: top; }
th { font-weight: 600; }
td code, th code { white-space: nowrap; }

/* Code overrides for doc flow (base styles in code.css) */
.code-wrap { margin: 1rem 0; }
.codeblock { font: .86rem/1.65 var(--mono); padding: 1.05rem 1.15rem; margin: 1rem 0; }
.copy { top: .55rem; right: .55rem; }

/* Footer spans the grid */
footer { grid-column: 1 / -1; }

.scrim { display: none; }

@media (max-width: 1200px) {
  .shell { grid-template-columns: 264px minmax(0, 1fr); }
  .onthispage { display: none; }
}
@media (max-width: 900px) {
  .shell { grid-template-columns: 1fr; }
  #menu-btn { display: inline-flex; }
  .sidebar {
    position: fixed; top: 52px; left: 0; bottom: 0; width: 280px; height: auto; z-index: 90;
    background: var(--bg); transform: translateX(-105%);
    transition: transform .32s cubic-bezier(.2, .7, .2, 1);
    box-shadow: 0 10px 40px rgba(0, 0, 0, 0.2);
  }
  .sidebar.open { transform: none; }
  .scrim.show { display: block; position: fixed; inset: 52px 0 0 0; background: rgba(0, 0, 0, 0.35); z-index: 80; }
  main { padding-top: 1.8rem; }
}
@media (max-width: 520px) {
  .nav-links { display: none; }
  .nav-tools { margin-left: auto; }
}