/* Documentation site: app-shell layout (sidebar + content + on-page TOC) and
   content typography. Reuses the design tokens from style.css (:root). The
   page chrome (header, sidebar, TOC, prev/next, mobile menu) is built by
   docs.js from a single page manifest, so each page file only carries its
   <article> content. */

:root {
  --doc-max: 1480px;
  --doc-sidebar: 256px;
  --doc-toc: 220px;
}

body.docs {
  margin: 0;
  min-width: 320px;
}

/* ---- top bar -------------------------------------------------------------- */

.dc-header {
  position: sticky;
  top: 0;
  z-index: 30;
  display: flex;
  align-items: center;
  gap: 1rem;
  height: 3.5rem;
  padding: 0 1.1rem;
  border-bottom: 1px solid var(--line);
  background: rgb(5 7 12 / 0.82);
  backdrop-filter: blur(18px);
}

.dc-brand {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  color: var(--ink);
  font-weight: 760;
  letter-spacing: -0.02em;
}

.dc-brand img {
  width: 1.7rem;
  height: 1.7rem;
  border-radius: 7px;
}

.dc-header .spacer {
  flex: 1;
}

.dc-header a.toplink {
  color: var(--muted);
  font-size: 0.9rem;
}

.dc-header a.toplink:hover {
  color: var(--ink);
}

.dc-ghbtn {
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  min-height: 2.1rem;
  padding: 0 0.8rem;
  border: 1px solid var(--linehard);
  border-radius: var(--radius);
  background: linear-gradient(180deg, rgb(255 255 255 / 0.12), rgb(255 255 255 / 0.05));
  color: var(--ink);
  font-size: 0.82rem;
  font-weight: 700;
}

.dc-burger {
  display: none;
  align-items: center;
  justify-content: center;
  width: 2.2rem;
  height: 2.2rem;
  border: 1px solid var(--linehard);
  border-radius: 8px;
  background: transparent;
  color: var(--ink);
  cursor: pointer;
  font-size: 1.1rem;
}

/* ---- layout grid ---------------------------------------------------------- */

.dc-grid {
  display: grid;
  grid-template-columns: var(--doc-sidebar) minmax(0, 1fr) var(--doc-toc);
  gap: 2.5rem;
  width: min(calc(100% - 2rem), var(--doc-max));
  margin: 0 auto;
  padding: 0 0 4rem;
}

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

.dc-sidebar {
  position: sticky;
  top: 3.5rem;
  align-self: start;
  height: calc(100svh - 3.5rem);
  overflow-y: auto;
  padding: 1.5rem 0.5rem 2rem 0;
  border-right: 1px solid var(--line);
}

.dc-sidebar .group {
  margin-bottom: 1.4rem;
}

.dc-sidebar .group > p {
  margin: 0 0 0.5rem;
  padding: 0 0.7rem;
  color: var(--mint);
  font-size: 0.72rem;
  font-weight: 760;
  letter-spacing: 0.02em;
  text-transform: uppercase;
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

.dc-sidebar a {
  display: block;
  padding: 0.42rem 0.7rem;
  border-radius: 7px;
  color: var(--muted);
  font-size: 0.9rem;
  line-height: 1.3;
}

.dc-sidebar a:hover {
  color: var(--ink);
  background: rgb(255 255 255 / 0.05);
}

.dc-sidebar a.active {
  color: var(--ink);
  background: rgb(110 180 255 / 0.14);
  box-shadow: inset 2px 0 0 var(--blue);
}

/* ---- main content --------------------------------------------------------- */

.doc-main {
  min-width: 0;
  padding-top: 2.2rem;
}

.doc-article {
  max-width: 56rem;
  color: var(--text);
}

.doc-article .kicker {
  margin: 0 0 0.6rem;
  color: var(--mint);
  font-size: 0.74rem;
  font-weight: 760;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

.doc-article h1 {
  margin: 0 0 0.9rem;
  color: var(--ink);
  font-size: clamp(2rem, 4vw, 2.7rem);
  line-height: 1.05;
  letter-spacing: -0.03em;
}

.doc-article .lede {
  margin: 0 0 2rem;
  color: var(--text);
  font-size: 1.12rem;
  line-height: 1.6;
}

.doc-article h2 {
  margin: 2.6rem 0 0.9rem;
  padding-top: 0.6rem;
  color: var(--ink);
  font-size: 1.5rem;
  line-height: 1.2;
  letter-spacing: -0.02em;
  scroll-margin-top: 4.5rem;
}

.doc-article h3 {
  margin: 1.8rem 0 0.6rem;
  color: var(--ink);
  font-size: 1.12rem;
  letter-spacing: -0.01em;
  scroll-margin-top: 4.5rem;
}

.doc-article h2 .anchor,
.doc-article h3 .anchor {
  margin-left: 0.4rem;
  color: var(--muted);
  opacity: 0;
  text-decoration: none;
  font-weight: 400;
}

.doc-article h2:hover .anchor,
.doc-article h3:hover .anchor {
  opacity: 1;
}

.doc-article p,
.doc-article li {
  font-size: 1rem;
  line-height: 1.72;
}

.doc-article p {
  margin: 0 0 1.1rem;
}

.doc-article ul,
.doc-article ol {
  margin: 0 0 1.2rem;
  padding-left: 1.3rem;
}

.doc-article li {
  margin: 0.3rem 0;
}

.doc-article a {
  color: var(--blue);
  text-decoration: none;
}

.doc-article a:hover {
  text-decoration: underline;
}

.doc-article strong {
  color: var(--ink);
}

.doc-article code {
  padding: 0.12em 0.4em;
  border-radius: 5px;
  background: rgb(255 255 255 / 0.08);
  color: var(--mint);
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.88em;
}

.doc-article pre {
  position: relative;
  margin: 0 0 1.4rem;
  padding: 1rem 1.1rem;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: 12px;
  background: var(--termbg);
}

.doc-article pre code {
  padding: 0;
  background: none;
  color: #cdd3e1;
  font-size: 0.86rem;
  line-height: 1.6;
}

.doc-article pre .copy {
  position: absolute;
  top: 0.55rem;
  right: 0.55rem;
  padding: 0.25rem 0.55rem;
  border: 1px solid var(--linehard);
  border-radius: 6px;
  background: rgb(255 255 255 / 0.06);
  color: var(--muted);
  font-size: 0.72rem;
  cursor: pointer;
}

.doc-article pre .copy:hover {
  color: var(--ink);
}

/* code comment / accent spans authors can use inside <pre> */
.doc-article pre .c {
  color: var(--muted);
}

/* ---- tables --------------------------------------------------------------- */

.doc-article .tablewrap {
  margin: 0 0 1.4rem;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: 12px;
}

.doc-article table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9rem;
}

.doc-article th,
.doc-article td {
  padding: 0.6rem 0.85rem;
  text-align: left;
  border-bottom: 1px solid var(--line);
  vertical-align: top;
}

.doc-article th {
  color: var(--ink);
  font-weight: 700;
  background: rgb(255 255 255 / 0.04);
}

.doc-article tr:last-child td {
  border-bottom: 0;
}

.doc-article td code {
  white-space: nowrap;
}

/* ---- callouts ------------------------------------------------------------- */

.doc-article .callout {
  margin: 0 0 1.4rem;
  padding: 0.9rem 1.1rem;
  border: 1px solid var(--line);
  border-left-width: 3px;
  border-radius: 10px;
  background: rgb(255 255 255 / 0.035);
}

.doc-article .callout p:last-child {
  margin-bottom: 0;
}

.doc-article .callout.note {
  border-left-color: var(--blue);
}

.doc-article .callout.tip {
  border-left-color: var(--mint);
}

.doc-article .callout.warn {
  border-left-color: var(--amber);
}

.doc-article .callout .label {
  display: block;
  margin-bottom: 0.3rem;
  font-size: 0.74rem;
  font-weight: 760;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.doc-article .callout.note .label {
  color: var(--blue);
}
.doc-article .callout.tip .label {
  color: var(--mint);
}
.doc-article .callout.warn .label {
  color: var(--amber);
}

/* keyboard key */
.doc-article kbd {
  display: inline-block;
  padding: 0.1em 0.45em;
  border: 1px solid var(--linehard);
  border-bottom-width: 2px;
  border-radius: 6px;
  background: rgb(255 255 255 / 0.06);
  color: var(--ink);
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.8em;
}

/* card grid for the overview hub */
.doc-article .cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
  gap: 1rem;
  margin: 0 0 1.5rem;
}

.doc-article .cards a {
  display: block;
  padding: 1.1rem;
  border: 1px solid var(--line);
  border-radius: 12px;
  background: linear-gradient(180deg, rgb(255 255 255 / 0.05), rgb(255 255 255 / 0.02));
  color: var(--text);
  text-decoration: none;
}

.doc-article .cards a:hover {
  border-color: var(--linehard);
  text-decoration: none;
}

.doc-article .cards strong {
  display: block;
  margin-bottom: 0.3rem;
  color: var(--ink);
  font-size: 1.02rem;
}

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

.dc-prevnext {
  display: flex;
  gap: 1rem;
  margin-top: 3rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--line);
}

.dc-prevnext a {
  flex: 1;
  padding: 0.9rem 1.1rem;
  border: 1px solid var(--line);
  border-radius: 12px;
  color: var(--ink);
  text-decoration: none;
}

.dc-prevnext a:hover {
  border-color: var(--linehard);
}

.dc-prevnext a span {
  display: block;
  color: var(--muted);
  font-size: 0.74rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.dc-prevnext a.next {
  text-align: right;
}

/* ---- on-page TOC ---------------------------------------------------------- */

.dc-toc {
  position: sticky;
  top: 3.5rem;
  align-self: start;
  max-height: calc(100svh - 3.5rem);
  overflow-y: auto;
  padding: 2.4rem 0 2rem;
}

.dc-toc > p {
  margin: 0 0 0.6rem;
  color: var(--muted);
  font-size: 0.72rem;
  font-weight: 760;
  text-transform: uppercase;
  letter-spacing: 0.04em;
}

.dc-toc a {
  display: block;
  padding: 0.25rem 0;
  color: var(--muted);
  font-size: 0.84rem;
  line-height: 1.35;
  border-left: 2px solid transparent;
  padding-left: 0.7rem;
  margin-left: -0.7rem;
}

.dc-toc a.sub {
  padding-left: 1.5rem;
  font-size: 0.8rem;
}

.dc-toc a:hover {
  color: var(--ink);
}

.dc-toc a.active {
  color: var(--ink);
  border-left-color: var(--blue);
}

/* ---- responsive ----------------------------------------------------------- */

@media (max-width: 1100px) {
  .dc-grid {
    grid-template-columns: var(--doc-sidebar) minmax(0, 1fr);
  }
  .dc-toc {
    display: none;
  }
}

@media (max-width: 820px) {
  .dc-burger {
    display: inline-flex;
  }
  .dc-grid {
    grid-template-columns: minmax(0, 1fr);
    gap: 0;
  }
  .dc-sidebar {
    position: fixed;
    top: 3.5rem;
    left: 0;
    bottom: 0;
    z-index: 25;
    width: 80%;
    max-width: 320px;
    padding: 1.5rem 1rem;
    border-right: 1px solid var(--linehard);
    background: var(--deep);
    transform: translateX(-105%);
    transition: transform 0.18s ease;
  }
  body.docs.nav-open .dc-sidebar {
    transform: translateX(0);
  }
  body.docs.nav-open::after {
    content: "";
    position: fixed;
    inset: 3.5rem 0 0;
    z-index: 24;
    background: rgb(0 0 0 / 0.5);
  }
  .doc-main {
    padding-top: 1.5rem;
  }
}

@media (prefers-reduced-motion: reduce) {
  .dc-sidebar {
    transition: none;
  }
}