/*
 * The documentation site.
 *
 * Tokens, fonts and the header come from styles.css, so a documentation page and
 * the marketing page are visibly the same product. This file only lays out a
 * three-column reading surface — navigation, prose, outline — and gives each
 * piece of a technical document its own manners: a code block is an instrument
 * panel, a callout is a margin note, a table is a ledger.
 *
 * Scale is deliberately tight. The prose is 15/1.7 with 68ch measure, headings
 * step 34 → 21 → 16.5, and every vertical rhythm value is a multiple of 4px so
 * the page reads as one grid rather than a stack of paragraphs.
 */

.guide {
  --g-side: 244px;
  --g-toc: 200px;
  --g-gutter: 48px;
  --g-header: 64px;
}

.guide .top {
  background: rgba(7, 17, 14, 0.86);
  backdrop-filter: blur(14px);
  -webkit-backdrop-filter: blur(14px);
  border-bottom: 1px solid var(--line);
}

.guide .top-inner {
  height: var(--g-header);
}

.guide .top-nav {
  font-size: 13px;
  gap: 26px;
}

.guide .top-nav a[aria-current="page"] {
  color: var(--text);
}

.guide .top-nav a[aria-current="page"]::after {
  background: var(--brass);
}

.g-navtoggle {
  display: none;
  font-family: var(--mono);
  font-size: 11.5px;
  letter-spacing: 0.02em;
  color: var(--body);
  background: transparent;
  border: 1px solid var(--line-2);
  border-radius: 6px;
  padding: 7px 12px;
  cursor: pointer;
}

.g-navtoggle:hover {
  color: var(--text);
  border-color: rgba(216, 164, 74, 0.55);
}

/* --- shell ----------------------------------------------------------------- */

.g-shell {
  width: min(1400px, 100% - 48px);
  margin-inline: auto;
  display: grid;
  grid-template-columns: var(--g-side) minmax(0, 1fr) var(--g-toc);
  gap: var(--g-gutter);
  align-items: start;
}

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

.g-side {
  position: sticky;
  top: var(--g-header);
  max-height: calc(100vh - var(--g-header));
  overflow-y: auto;
  padding: 28px 20px 48px 0;
  border-right: 1px solid var(--line);
  font-size: 13px;
  scrollbar-width: thin;
  scrollbar-color: rgba(233, 239, 231, 0.14) transparent;
}

.g-search {
  width: 100%;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  margin-bottom: 24px;
  padding: 7px 9px;
  background: var(--ink-2);
  border: 1px solid var(--line);
  border-radius: 7px;
  color: var(--dim);
  font: inherit;
  font-size: 12.5px;
  cursor: text;
  transition: border-color 150ms ease, color 150ms ease, background 150ms ease;
}

.g-search:hover {
  border-color: var(--line-2);
  background: var(--ink-3);
  color: var(--body);
}

.g-search kbd {
  font-family: var(--mono);
  font-size: 10px;
  line-height: 1;
  color: var(--dim);
  border: 1px solid var(--line-2);
  border-radius: 4px;
  padding: 2px 5px;
}

.g-nav-group {
  margin-bottom: 22px;
}

.g-nav-group:last-child {
  margin-bottom: 0;
}

.g-nav-head {
  margin: 0 0 6px;
  padding-left: 11px;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--dim);
}

.g-link {
  position: relative;
  display: block;
  padding: 4px 8px 4px 11px;
  margin-left: -1px;
  border-left: 2px solid transparent;
  border-radius: 0 5px 5px 0;
  color: var(--body);
  font-size: 13px;
  line-height: 1.4;
  transition: color 130ms ease, background 130ms ease, border-color 130ms ease;
}

.g-link:hover {
  color: var(--text);
  background: rgba(233, 239, 231, 0.04);
}

.g-link.is-active {
  color: var(--text);
  border-left-color: var(--brass);
  background: rgba(216, 164, 74, 0.09);
  font-weight: 500;
}

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

.g-main {
  min-width: 0;
  padding: 36px 0 88px;
}

.g-crumb {
  display: flex;
  gap: 7px;
  align-items: center;
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.06em;
  color: var(--dim);
  text-transform: uppercase;
}

.g-crumb a:hover {
  color: var(--body);
}

.g-main > h1 {
  margin: 12px 0 8px;
  font-size: clamp(28px, 3vw, 34px);
  line-height: 1.14;
  letter-spacing: -0.022em;
  font-weight: 600;
  color: var(--text);
}

.g-lede {
  margin: 0 0 28px;
  padding-bottom: 22px;
  border-bottom: 1px solid var(--line);
  font-size: 16px;
  line-height: 1.55;
  color: var(--body);
  max-width: 68ch;
}

/* --- prose ----------------------------------------------------------------- */

.g-prose {
  max-width: 68ch;
  font-size: 15px;
  line-height: 1.7;
  color: var(--body);
}

.g-prose > * {
  margin-block: 0;
}

.g-prose > * + * {
  margin-top: 0.95em;
}

.g-prose h2 {
  margin: 1.9em 0 0.55em;
  padding-top: 0.85em;
  border-top: 1px solid var(--line);
  font-size: 21px;
  line-height: 1.28;
  letter-spacing: -0.012em;
  font-weight: 600;
  color: var(--text);
  scroll-margin-top: calc(var(--g-header) + 22px);
}

.g-prose h3 {
  margin: 1.5em 0 0.35em;
  font-size: 16.5px;
  line-height: 1.35;
  letter-spacing: -0.008em;
  font-weight: 600;
  color: var(--text);
  scroll-margin-top: calc(var(--g-header) + 22px);
}

.g-prose h4 {
  margin: 1.4em 0 0.3em;
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
}

.g-prose > h2:first-child,
.g-prose > h3:first-child {
  margin-top: 0.4em;
  padding-top: 0;
  border-top: 0;
}

.g-prose .g-anchor {
  margin-left: -0.9em;
  padding-right: 0.24em;
  color: transparent;
  font-weight: 400;
  /* The anchor inherits the prose link underline; without this it draws a brass
     tick in the margin before every heading. */
  text-decoration: none;
  transition: color 130ms ease;
}

.g-prose h2:hover .g-anchor,
.g-prose h3:hover .g-anchor,
.g-prose .g-anchor:focus-visible {
  color: var(--brass);
}

.g-prose a {
  color: var(--text);
  text-decoration: underline;
  text-decoration-color: rgba(216, 164, 74, 0.4);
  text-decoration-thickness: 1px;
  text-underline-offset: 3px;
  transition: color 130ms ease, text-decoration-color 130ms ease;
}

.g-prose a:hover {
  color: var(--brass-bright);
  text-decoration-color: var(--brass-bright);
}

.g-prose strong {
  color: var(--text);
  font-weight: 600;
}

.g-prose h2 code,
.g-prose h3 code,
.g-prose h4 code {
  font-size: 0.84em;
  color: inherit;
  background: none;
  padding: 0;
  letter-spacing: -0.01em;
}

.g-prose code {
  font-family: var(--mono);
  font-size: 0.86em;
  color: #e2ebe4;
  background: rgba(233, 239, 231, 0.075);
  border: 0;
  border-radius: 4px;
  padding: 0.12em 0.34em;
  /* Long endpoints must be able to break inside a paragraph; a chip that
     overflows its column is worse than a chip split across two lines. */
  white-space: normal;
  overflow-wrap: break-word;
}

.g-prose ul,
.g-prose ol {
  margin: 0;
  padding-left: 1.25em;
}

.g-prose li {
  margin: 0.3em 0;
}

.g-prose li > p {
  margin: 0.3em 0;
}

.g-prose li > ul,
.g-prose li > ol {
  margin: 0.3em 0;
}

.g-prose li::marker {
  color: var(--brass);
}

.g-prose li li::marker {
  color: var(--dim);
}

.g-prose hr {
  border: 0;
  border-top: 1px solid var(--line);
  margin: 2.2em 0;
}

.g-prose blockquote {
  margin: 1.3em 0;
  padding: 2px 0 2px 16px;
  border-left: 2px solid var(--brass);
  color: var(--paper-2);
  font-family: var(--serif);
  font-size: 16px;
  font-style: italic;
}

/* --- code ------------------------------------------------------------------ */

.g-code {
  margin: 1.15em 0;
  border: 1px solid rgba(233, 239, 231, 0.14);
  border-radius: 8px;
  /* Lighter than the page, the way a raised instrument panel reads: the code
     surface separates itself without a heavy outline. */
  background: #0a1512;
  overflow: hidden;
  box-shadow: inset 0 1px 0 rgba(233, 239, 231, 0.05);
}

.g-code-head {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 6px 10px;
  border-bottom: 1px solid rgba(233, 239, 231, 0.1);
  background: rgba(233, 239, 231, 0.035);
}

.g-lang {
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  color: #93a79d;
}

.g-copy {
  font-family: var(--mono);
  font-size: 10.5px;
  letter-spacing: 0.02em;
  color: var(--dim);
  background: transparent;
  border: 1px solid transparent;
  border-radius: 4px;
  padding: 2px 7px;
  cursor: pointer;
  transition: color 130ms ease, border-color 130ms ease, background 130ms ease;
}

.g-copy:hover {
  color: var(--text);
  border-color: var(--line-2);
  background: rgba(233, 239, 231, 0.05);
}

.g-code pre {
  margin: 0;
  padding: 12px 14px;
  overflow-x: auto;
  font-family: var(--mono);
  font-size: 12.5px;
  line-height: 1.62;
  color: #dfeae2;
  tab-size: 2;
}

.g-code pre code {
  background: none;
  border: 0;
  padding: 0;
  color: inherit;
  white-space: pre;
  font-size: inherit;
}

.g-code pre::-webkit-scrollbar {
  height: 8px;
}

.g-code pre::-webkit-scrollbar-track {
  background: rgba(233, 239, 231, 0.04);
}

.g-code pre::-webkit-scrollbar-thumb {
  background: rgba(233, 239, 231, 0.22);
  border-radius: 4px;
}

.g-code pre::-webkit-scrollbar-thumb:hover {
  background: rgba(233, 239, 231, 0.34);
}

.g-code pre {
  scrollbar-width: thin;
  scrollbar-color: rgba(233, 239, 231, 0.24) transparent;
}

/* --- tabs ------------------------------------------------------------------ */

.g-tabs {
  margin: 1.15em 0;
  border: 1px solid rgba(233, 239, 231, 0.14);
  border-radius: 8px;
  /* Lighter than the page, the way a raised instrument panel reads: the code
     surface separates itself without a heavy outline. */
  background: #0a1512;
  overflow: hidden;
  box-shadow: inset 0 1px 0 rgba(233, 239, 231, 0.05);
}

.g-tabbar {
  display: flex;
  gap: 2px;
  padding: 0 8px;
  border-bottom: 1px solid rgba(233, 239, 231, 0.1);
  background: rgba(233, 239, 231, 0.035);
  overflow-x: auto;
  scrollbar-width: none;
}

.g-tabbar::-webkit-scrollbar {
  display: none;
}

.g-tab {
  font-family: var(--mono);
  font-size: 11px;
  letter-spacing: 0.02em;
  color: #84998f;
  background: transparent;
  border: 0;
  border-bottom: 2px solid transparent;
  padding: 8px 9px;
  margin-bottom: -1px;
  cursor: pointer;
  white-space: nowrap;
  transition: color 130ms ease, border-color 130ms ease;
}

.g-tab:hover {
  color: var(--body);
}

.g-tab.is-active {
  color: var(--text);
  border-bottom-color: var(--brass);
}

.g-tabs .g-pane {
  display: none;
}

.g-tabs .g-pane.is-active {
  display: block;
}

.g-tabs .g-code {
  margin: 0;
  border: 0;
  border-radius: 0;
  background: transparent;
  box-shadow: none;
}

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

.g-callout {
  margin: 1.3em 0;
  padding: 11px 15px;
  border: 1px solid var(--line);
  border-left: 2px solid var(--brass);
  border-radius: 0 7px 7px 0;
  background: rgba(233, 239, 231, 0.028);
  font-size: 14px;
  line-height: 1.65;
}

.g-callout > * + * {
  margin-top: 0.5em;
}

.g-callout-title {
  margin: 0;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--brass-bright);
}

.g-callout-note,
.g-callout-tip {
  border-left-color: var(--mint);
}

.g-callout-note .g-callout-title,
.g-callout-tip .g-callout-title {
  color: var(--mint);
}

.g-callout-warning {
  border-left-color: var(--rust);
}

.g-callout-warning .g-callout-title {
  color: #e08d70;
}

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

.g-table-wrap {
  margin: 1.25em 0;
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: 7px;
}

.g-prose table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13.5px;
  line-height: 1.5;
}

.g-prose th {
  text-align: left;
  padding: 7px 12px;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--muted);
  border-bottom: 1px solid var(--line-2);
  background: rgba(233, 239, 231, 0.03);
  white-space: nowrap;
}

.g-prose td {
  padding: 7px 12px;
  border-bottom: 1px solid var(--line);
  vertical-align: top;
}

.g-prose tr:last-child td {
  border-bottom: 0;
}

.g-prose td code {
  white-space: nowrap;
}

/* --- outline --------------------------------------------------------------- */

.g-toc {
  position: sticky;
  top: var(--g-header);
  max-height: calc(100vh - var(--g-header));
  overflow-y: auto;
  padding: 44px 0 40px;
  font-size: 12.5px;
  scrollbar-width: thin;
  scrollbar-color: rgba(233, 239, 231, 0.12) transparent;
}

.g-toc-head {
  margin: 0 0 8px;
  padding-left: 11px;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--dim);
}

.g-toc-link {
  display: block;
  padding: 3px 8px 3px 11px;
  border-left: 1px solid var(--line);
  color: var(--muted);
  font-size: 12.5px;
  line-height: 1.4;
  transition: color 130ms ease, border-color 130ms ease;
}

.g-toc-link.is-sub {
  padding-left: 22px;
  font-size: 12px;
  color: #7f938a;
}

.g-toc-link:hover {
  color: var(--body);
}

.g-toc-link.is-active {
  color: var(--text);
  border-left-color: var(--brass);
  border-left-width: 1px;
  font-weight: 500;
}

/* --- footer of the page ---------------------------------------------------- */

.g-next-card {
  margin: 48px 0 0;
  padding: 18px 20px;
  display: grid;
  gap: 8px;
  justify-items: start;
  border: 1px solid var(--line);
  border-radius: 8px;
  background:
    radial-gradient(420px 160px at 88% -30%, rgba(216, 164, 74, 0.09), transparent 70%),
    var(--ink-2);
  max-width: 68ch;
}

.g-next-eyebrow {
  margin: 0;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--brass-bright);
}

.g-next-card p {
  margin: 0;
  color: var(--body);
  font-size: 14px;
  line-height: 1.55;
}

.g-next-card .btn {
  margin-top: 4px;
  padding: 8px 14px;
  font-size: 12.5px;
}

.g-pager {
  margin-top: 28px;
  display: flex;
  justify-content: space-between;
  gap: 14px;
  max-width: 68ch;
}

.g-pager-link {
  flex: 1;
  display: grid;
  gap: 2px;
  padding: 11px 14px;
  border: 1px solid var(--line);
  border-radius: 7px;
  color: var(--body);
  transition: border-color 130ms ease, background 130ms ease;
}

.g-pager-link:hover {
  border-color: var(--line-2);
  background: rgba(233, 239, 231, 0.03);
}

.g-pager-link span {
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--dim);
}

.g-pager-link strong {
  font-size: 13.5px;
  font-weight: 600;
  color: var(--text);
}

.g-pager-link.is-next {
  text-align: right;
}

.g-foot {
  border-top: 1px solid var(--line);
  margin-top: 32px;
}

.g-foot .foot-base {
  font-size: 12px;
}

/* --- search ---------------------------------------------------------------- */

.g-search-modal {
  position: fixed;
  inset: 0;
  z-index: 200;
  display: grid;
  place-items: start center;
  padding-top: min(14vh, 132px);
}

.g-search-modal[hidden] {
  display: none;
}

.g-search-backdrop {
  position: absolute;
  inset: 0;
  background: rgba(3, 8, 6, 0.72);
  backdrop-filter: blur(4px);
}

.g-search-panel {
  position: relative;
  width: min(600px, 100% - 32px);
  border: 1px solid var(--line-2);
  border-radius: 10px;
  background: var(--ink-2);
  box-shadow: 0 30px 80px rgba(0, 0, 0, 0.55);
  overflow: hidden;
}

.g-search-input {
  width: 100%;
  padding: 14px 16px;
  font: inherit;
  font-size: 14px;
  color: var(--text);
  background: transparent;
  border: 0;
  border-bottom: 1px solid var(--line);
  outline: none;
}

.g-search-input::placeholder {
  color: var(--dim);
}

.g-search-results {
  max-height: min(50vh, 400px);
  overflow-y: auto;
  padding: 6px;
}

.g-search-hit {
  display: grid;
  gap: 2px;
  padding: 9px 11px;
  border-radius: 7px;
  color: var(--body);
}

.g-search-hit:hover,
.g-search-hit.is-active {
  background: rgba(233, 239, 231, 0.05);
}

.g-search-hit strong {
  color: var(--text);
  font-weight: 600;
  font-size: 13.5px;
}

.g-search-hit span {
  font-size: 12.5px;
  line-height: 1.5;
  color: var(--muted);
  display: -webkit-box;
  -webkit-line-clamp: 2;
  -webkit-box-orient: vertical;
  overflow: hidden;
}

.g-search-hit em {
  font-style: normal;
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.07em;
  text-transform: uppercase;
  color: var(--dim);
}

.g-search-empty {
  padding: 20px;
  text-align: center;
  color: var(--muted);
  font-size: 13.5px;
}

.g-search-hint {
  margin: 0;
  padding: 8px 12px;
  border-top: 1px solid var(--line);
  font-family: var(--mono);
  font-size: 10px;
  letter-spacing: 0.03em;
  color: var(--dim);
}

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

@media (max-width: 1180px) {
  .g-shell {
    grid-template-columns: var(--g-side) minmax(0, 1fr);
    gap: 40px;
  }

  .g-toc {
    display: none;
  }
}

@media (max-width: 900px) {
  .guide {
    --g-gutter: 0px;
    --g-header: 60px;
  }

  .g-shell {
    width: min(100% - 36px, 720px);
    grid-template-columns: minmax(0, 1fr);
  }

  .g-navtoggle {
    display: inline-block;
    margin-left: auto;
  }

  /* A drawer, not a pushed-down column: the header stays put, the page behind
     dims, and the menu closes as soon as a page is chosen. */
  .g-side {
    display: none;
    position: fixed;
    top: var(--g-header);
    left: 0;
    right: 0;
    bottom: 0;
    z-index: 60;
    max-height: none;
    padding: 18px 22px 40px;
    border-right: 0;
    border-bottom: 1px solid var(--line-2);
    background: #08120f;
    box-shadow: 0 24px 60px rgba(0, 0, 0, 0.5);
    overflow-y: auto;
  }

  .g-side.is-open {
    display: block;
  }

  /* On a tablet the drawer is a panel, not the whole screen: the page stays
     visible beside it and the scrim explains why the page is dimmed. */
  @media (min-width: 560px) {
    .g-side {
      right: auto;
      width: 330px;
      border-right: 1px solid var(--line-2);
      border-bottom: 0;
    }
  }

  body.g-nav-open::before {
    content: "";
    position: fixed;
    inset: var(--g-header) 0 0;
    z-index: 50;
    background: rgba(3, 8, 6, 0.55);
  }

  body.g-nav-open {
    overflow: hidden;
  }

  .g-side .g-link {
    padding: 8px 10px 8px 11px;
    font-size: 14px;
  }

  .g-search {
    margin-bottom: 18px;
    padding: 9px 10px;
  }

  .g-main {
    padding-top: 24px;
  }

  .g-main > h1 {
    font-size: 28px;
  }

  .g-lede {
    font-size: 15.5px;
  }

  .g-prose {
    font-size: 15px;
  }

  .g-prose h2 {
    font-size: 19.5px;
  }

  .g-code pre {
    font-size: 12px;
  }

  .g-pager {
    flex-direction: column;
  }

  .g-pager-link.is-next {
    text-align: left;
  }
}

@media (prefers-reduced-motion: reduce) {
  .g-prose,
  .g-link,
  .g-toc-link,
  .g-tab,
  .g-copy {
    transition: none;
  }
}
