/* Docs layout only — colors/fonts/chrome come from marketing styles.css */

/* Map Material tokens onto marketing CSS variables */
[data-md-color-scheme="default"],
:root {
  --md-default-bg-color: var(--bg);
  --md-default-bg-color--light: var(--panel);
  --md-default-bg-color--lighter: var(--bg-mid);
  --md-default-bg-color--lightest: var(--panel);
  --md-default-fg-color: var(--ink);
  --md-default-fg-color--light: var(--ink-secondary);
  --md-default-fg-color--lighter: var(--ink-tertiary);
  --md-default-fg-color--lightest: var(--line);
  --md-primary-fg-color: var(--accent);
  --md-primary-bg-color: var(--panel);
  --md-accent-fg-color: var(--accent);
  --md-accent-fg-color--transparent: var(--accent-soft);
  --md-typeset-a-color: var(--link, var(--accent));
  --md-typeset-color: var(--ink);
  --md-footer-bg-color: transparent;
  --md-footer-bg-color--dark: transparent;
  --md-code-bg-color: var(--accent-soft);
  --md-code-fg-color: var(--ink);
}

[data-md-color-scheme="slate"] {
  --md-default-bg-color: var(--bg);
  --md-default-bg-color--light: var(--panel);
  --md-default-bg-color--lighter: var(--control);
  --md-default-bg-color--lightest: var(--control);
  --md-default-fg-color: var(--ink);
  --md-default-fg-color--light: var(--ink-secondary);
  --md-default-fg-color--lighter: var(--ink-tertiary);
  --md-default-fg-color--lightest: var(--line);
  --md-primary-fg-color: var(--accent);
  --md-primary-bg-color: var(--bg);
  --md-accent-fg-color: var(--accent);
  --md-accent-fg-color--transparent: var(--accent-soft);
  --md-typeset-a-color: var(--link, var(--accent));
  --md-code-bg-color: var(--accent-soft);
}

/* Brand mark: styles.css points at logo.png beside the stylesheet (hooks copy it) */
.md-typeset,
.md-nav,
.md-header,
.md-footer,
.md-search,
body {
  font-family: var(--font);
}

.md-typeset h1,
.md-typeset h2,
.md-typeset h3 {
  font-family: var(--display);
  letter-spacing: -0.025em;
  font-weight: 700;
}

/* Atmosphere is fixed at z-index 0. Do not create stacking contexts on
   .md-container / .md-main — they trap the mobile drawer under .md-overlay
   so taps close the menu instead of navigating. */
.yg-site-footer {
  position: relative;
  z-index: 1;
}

/* Docs article must sit above the fixed atmosphere. Scoped to .md-content
   (a sibling of the sidebars) so the phone drawer stacking is unaffected. */
.md-content {
  position: relative;
  z-index: 1;
}

body {
  background: transparent;
}

/*
 * Material sets html { font-size: 125% }, so rem from styles.css is ~25% large.
 * Chrome uses px sized to the marketing 16px root (index.html / styles.css).
 * Scoped to .yg-docs-* so marketing pages are unchanged.
 */
.yg-docs-topbar {
  display: flex;
  flex-wrap: nowrap;
  align-items: center;
  justify-content: space-between;
  gap: 8px 12px;
  /* 32px = 2rem @ marketing 16px root (not Material's 20px rem) */
  width: min(1280px, calc(100% - 32px));
  max-width: 1280px;
  min-height: 64px;
  margin: 0 auto 24px;
  padding: 13.6px 0;
  position: sticky;
  top: 0;
  /* Below Material overlay/drawer (5) so the open menu receives taps */
  z-index: 3;
  /* Opaque so scrolling docs don't bleed through the sticky chrome */
  background: var(--bg);
  backdrop-filter: none;
  box-shadow: none;
  border-bottom: 1px solid var(--line);
}

/* Full-bleed opaque strip (bar itself is max-width constrained) */
.yg-docs-topbar::before {
  content: "";
  position: absolute;
  top: 0;
  bottom: -1px; /* cover border-bottom seam */
  left: 50%;
  width: 100vw;
  transform: translateX(-50%);
  background: var(--bg);
  border-bottom: 1px solid var(--line);
  z-index: -1;
  pointer-events: none;
}

@media (min-width: 1600px) {
  .yg-docs-topbar {
    width: min(1440px, calc(100% - 48px));
    max-width: 1440px;
  }
}

.yg-docs-topbar .brand {
  flex: 0 0 auto;
  gap: 9.6px;
  /* Match marketing computed size: .topbar a wins over .brand (0.9rem @ 16px) */
  font-size: 14.4px;
  padding: 6.4px 10.4px;
}

.yg-docs-topbar .brand .brand-mark {
  width: 28px;
  height: 28px;
}

.yg-docs-topbar .yg-site-nav {
  display: flex;
  flex-wrap: nowrap;
  align-items: center;
  gap: 2.4px;
  flex: 1 1 auto;
  justify-content: flex-end;
  min-width: 0;
  width: auto;
}

.yg-docs-topbar .yg-site-nav a,
.yg-docs-topbar .theme-toggle {
  color: var(--ink-secondary);
  font-size: 14.4px;
  font-weight: 500;
  padding: 6.4px 10.4px;
  border-radius: 8px;
  text-decoration: none;
  white-space: nowrap;
}

.yg-docs-topbar .yg-site-nav a:hover,
.yg-docs-topbar .yg-site-nav a[aria-current="page"],
.yg-docs-topbar .theme-toggle:hover {
  color: var(--ink);
  background: var(--accent-soft);
  text-decoration: none;
}

.yg-docs-topbar .yg-site-nav a.nav-quiet {
  color: var(--ink-tertiary);
  font-weight: 400;
  font-size: 13.12px;
  opacity: 0.85;
}

.yg-docs-topbar .yg-site-nav a.nav-quiet:hover {
  opacity: 1;
}

.yg-docs-drawer {
  color: var(--ink-secondary);
  margin: 0;
  flex: 0 0 auto;
}

.yg-docs-tools {
  display: flex;
  align-items: center;
  gap: 4px;
  flex: 0 0 auto;
  height: 32px;
  max-height: 32px;
}

.yg-docs-tools .md-header__button {
  color: var(--ink-secondary);
  width: 32px;
  height: 32px;
  margin: 0;
  padding: 0;
}

.yg-docs-tools .md-search,
.yg-docs-tools .md-search__inner {
  height: 32px;
  max-height: 32px;
}

.yg-docs-tools .md-search__form {
  height: 32px;
  border-radius: 8px;
  background: var(--control);
  border: 1px solid var(--line);
  box-shadow: none;
}

.yg-docs-tools .md-search__input {
  font-size: 13px;
  color: var(--ink);
}

.yg-docs-tools .md-search__input::placeholder,
.md-search__input::placeholder {
  color: var(--ink-tertiary);
  opacity: 1;
}

@media screen and (min-width: 60em) {
  .yg-docs-tools .md-search__form {
    width: 9.5rem;
  }
}

@media screen and (min-width: 1220px) {
  .yg-docs-drawer {
    display: none !important;
  }
}

/* Under 1100px: site links live in the Material drawer (see nav.html), not a second topbar row */
@media screen and (max-width: 1100px) {
  .yg-docs-topbar {
    flex-wrap: nowrap;
    min-height: 56px;
    max-height: 64px;
    height: 56px;
    padding: 6px 0;
    gap: 8px;
  }

  .yg-docs-topbar .yg-site-nav {
    display: none !important;
  }

  .yg-docs-topbar .brand {
    min-width: 0;
    padding-left: 0;
  }

  .yg-docs-drawer {
    margin-left: auto;
  }

  .yg-drawer-site {
    display: block;
    margin: 0 0 12px;
    padding: 0 0 12px;
    border-bottom: 1px solid var(--line);
  }

  .yg-drawer-site .md-nav__link {
    font-size: 14px;
    font-weight: 500;
  }

  .yg-drawer-site .theme-toggle.md-nav__link {
    width: 100%;
    text-align: left;
    border: 0;
    background: transparent;
    cursor: pointer;
    font-family: inherit;
    color: var(--ink-secondary);
  }

  .yg-drawer-site .theme-toggle.md-nav__link:hover,
  .yg-drawer-site .theme-toggle.md-nav__link:focus-visible {
    color: var(--ink);
    background: var(--accent-soft);
  }
}

@media screen and (min-width: 1101px) {
  .yg-drawer-site {
    display: none !important;
  }
}

.md-main {
  background: transparent;
}

.md-sidebar {
  background: transparent;
}

/*
 * Left rail: quiet editorial nav (not Material pills).
 * Sized in px so Material's 125% root does not inflate it.
 * Material's sidebar box is only ~header-tall; a border there looks like a
 * short stub. Draw the divider on the absolute scrollwrap (full column).
 */
.md-sidebar--primary {
  border-right: none !important;
}

.md-sidebar--primary .md-sidebar__scrollwrap {
  scrollbar-width: thin;
  scrollbar-color: var(--line) transparent;
}

@media screen and (min-width: 1220px) {
  .md-sidebar--primary .md-sidebar__scrollwrap {
    border-right: 1px solid var(--line);
  }
}

.md-sidebar--primary .md-nav {
  font-size: 13px;
  line-height: 1.35;
}

.md-sidebar--primary .md-nav__list {
  padding: 0 0 8px;
}

.md-sidebar--primary .md-nav__item {
  padding: 0;
  margin: 0;
}

.md-nav--primary .md-nav__link {
  color: var(--ink-secondary);
  background: transparent;
  border-radius: 0;
  box-shadow: none;
  margin: 0;
  padding: 5px 0 5px 12px;
  font-size: 13px;
  font-weight: 400;
  letter-spacing: -0.01em;
  transition: color 0.15s ease;
}

.md-nav--primary .md-nav__link:hover,
.md-nav--primary .md-nav__link:focus {
  color: var(--ink);
  background: transparent;
}

/* Section labels — match marketing .section-label */
.md-nav--primary .md-nav__item--section > .md-nav__link,
.md-nav--primary .md-nav__item--section > label.md-nav__link {
  color: var(--ink-tertiary);
  font-size: 11px;
  font-weight: 650;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  background: transparent;
  margin: 18px 0 4px;
  padding: 0 0 0 12px;
}

.md-nav--primary .md-nav__item--section:first-child > .md-nav__link,
.md-nav--primary .md-nav__item--section:first-child > label.md-nav__link {
  margin-top: 4px;
}

/* Active page: ink + weight + thin rule — no pill fill */
.md-nav--primary .md-nav__item--active:not(.md-nav__item--section) > .md-nav__link,
.md-nav--primary a.md-nav__link--active {
  color: var(--ink);
  background: transparent;
  font-weight: 600;
  box-shadow: inset 2px 0 0 var(--accent);
}

/* Nested section pages sit slightly indented */
.md-nav--primary .md-nav__item--section > .md-nav .md-nav__link {
  padding-left: 12px;
}

/* Hide in-page TOC under the current page — right rail already has it */
.md-nav--primary .md-nav__item--active:not(.md-nav__item--section) > .md-nav {
  display: none;
}

/* Desktop: section labels are non-interactive (always expanded); hide chevrons.
   Phone drawer: keep arrows + pointer events so nested sections drill in. */
@media screen and (min-width: 1220px) {
  .md-nav--primary .md-nav__item--section > .md-nav__link,
  .md-nav--primary .md-nav__item--section > label.md-nav__link {
    pointer-events: none;
  }

  .md-nav--primary .md-nav__item--section > .md-nav__link .md-nav__icon,
  .md-nav--primary .md-nav__item--section > label.md-nav__link .md-nav__icon {
    display: none;
  }
}

.md-nav--primary .md-nav__icon {
  opacity: 0.45;
  width: 14px;
  height: 14px;
  margin-left: auto;
  margin-right: 4px;
  color: var(--ink-tertiary);
}

/* Right TOC — same quiet language as left rail */
.md-sidebar--secondary {
  border-left: 0 !important;
}

/*
 * Material: [dir=ltr] .md-nav--secondary .md-nav__list { padding-left: .6rem }
 * Zero that so the label and top-level items share one left edge.
 */
[dir=ltr] .md-sidebar--secondary .md-nav--secondary > .md-nav__list,
[dir=ltr] .md-sidebar--secondary .md-nav--secondary .md-nav__list,
.md-sidebar--secondary .md-nav--secondary > .md-nav__list,
.md-sidebar--secondary .md-nav--secondary .md-nav__list {
  padding-left: 0 !important;
  margin-left: 0 !important;
}

.md-sidebar--secondary .md-nav--secondary > .md-nav__title,
.md-nav--secondary .md-nav__title {
  color: var(--ink-tertiary);
  background: transparent;
  box-shadow: none;
  font-size: 11px;
  font-weight: 650;
  letter-spacing: 0.04em;
  text-transform: uppercase;
  /* Shared --yg-toc-inset with top-level links */
  --yg-toc-inset: 12px;
  padding: 0 0 8px var(--yg-toc-inset);
  height: auto;
  line-height: 1.3;
  display: block;
}

.md-sidebar--secondary .md-nav--secondary > .md-nav__title .md-nav__icon,
.md-nav--secondary .md-nav__title .md-nav__icon {
  display: none !important;
}

[dir=ltr] .md-sidebar--secondary .md-nav--secondary > .md-nav__list > .md-nav__item > .md-nav__link,
.md-sidebar--secondary .md-nav--secondary > .md-nav__list > .md-nav__item > .md-nav__link,
.md-nav--secondary .md-nav__link {
  color: var(--ink-secondary);
  font-size: 12.5px;
  border-radius: 0;
  margin: 0;
  --yg-toc-inset: 12px;
  padding: 4px 0 4px var(--yg-toc-inset);
  background: transparent;
  box-shadow: none;
  border-left: 0 !important;
}

.md-nav--secondary .md-nav__link:hover,
.md-nav--secondary .md-nav__link:focus {
  color: var(--ink);
  background: transparent;
}

.md-nav--secondary .md-nav__link--active {
  color: var(--ink);
  font-weight: 600;
  background: transparent;
  box-shadow: inset 2px 0 0 var(--accent);
}

/* Nested TOC levels keep a clear step without shifting the label */
[dir=ltr] .md-sidebar--secondary .md-nav--secondary .md-nav .md-nav__link {
  padding-left: calc(var(--yg-toc-inset, 12px) + 10px);
}

/*
 * Phone drawer: solid panel on top of the dimming layer; title bar matches site
 * (not Material primary blue). Use px breakpoint — Material's em root is 125%.
 */
@media screen and (max-width: 1219px) {
  .md-overlay {
    z-index: 5;
  }

  .md-sidebar--primary {
    background-color: var(--bg) !important;
    z-index: 6;
    border-right: 1px solid var(--line);
  }

  /* Material paints [for=__drawer] with --md-primary-fg-color (blue) */
  .md-nav--primary .md-nav__title,
  .md-nav--primary .md-nav__title[for="__drawer"] {
    background-color: var(--bg) !important;
    background: var(--bg) !important;
    color: var(--ink) !important;
    box-shadow: none !important;
    border-bottom: 1px solid var(--line);
    height: auto;
    min-height: 52px;
    line-height: 1.3;
    padding: 14px 12px;
    font-family: var(--display);
    font-size: 14.4px;
    font-weight: 700;
    letter-spacing: -0.03em;
  }

  .md-nav--primary .md-nav__title[for="__drawer"] {
    display: flex;
    align-items: center;
    gap: 8px;
    padding: 12px;
  }

  /* Nested level titles keep Material back-arrow layout */
  .md-nav--primary .md-nav__title:not([for="__drawer"]) {
    padding: 14px 12px 14px 40px;
  }

  .md-nav--primary .md-nav__title:not([for="__drawer"]) .md-nav__icon {
    display: block;
    color: var(--ink-secondary);
  }

  /* Material absolute-positions a huge logo over the title — shrink to site mark */
  .md-nav--primary .md-nav__title[for="__drawer"] .md-logo {
    position: static;
    display: block;
    flex: 0 0 auto;
    width: 28px;
    height: 28px;
    margin: 0;
    padding: 0;
    left: auto;
    right: auto;
    top: auto;
  }

  .md-nav--primary .md-nav__title[for="__drawer"] .md-logo img,
  .md-nav--primary .md-nav__title[for="__drawer"] .md-logo svg {
    width: 28px;
    height: 28px;
    max-width: 28px;
  }

  /*
   * Nested drill-in panels stay opacity:0 when closed but still hit-test.
   * That steals taps from the root menu (and can leave scrollwrap scrolled).
   */
  .md-nav--primary .md-nav__item--nested > .md-nav {
    pointer-events: none;
  }

  .md-nav--primary .md-nav__item--nested > input:checked ~ .md-nav {
    pointer-events: auto;
  }

  /* Section rows in the drawer: tappable with visible arrows */
  .md-nav--primary .md-nav__item--section > .md-nav__link,
  .md-nav--primary .md-nav__item--section > label.md-nav__link {
    pointer-events: auto;
    display: flex;
    align-items: center;
    margin: 10px 0 2px;
    padding: 8px 8px 8px 12px;
    font-size: 11px;
    cursor: pointer;
  }

  .md-nav--primary .md-nav__item--section > .md-nav__link .md-nav__icon,
  .md-nav--primary .md-nav__item--section > label.md-nav__link .md-nav__icon {
    display: block;
    flex: 0 0 auto;
  }

  .md-nav--primary .md-nav__link {
    padding: 8px 12px;
  }
}

.md-content__inner {
  background: var(--panel);
  border: 1px solid var(--line);
  border-radius: var(--radius);
  padding: 1.1rem 1.35rem 1.6rem;
  margin-top: 0.75rem;
  margin-bottom: 1rem;
  box-shadow: none;
}

.md-typeset h1 {
  color: var(--ink);
  font-size: 1.75rem;
  margin-top: 0;
}

.md-typeset .admonition,
.md-typeset details {
  border-radius: var(--radius);
  border: 1px solid var(--line);
  border-left: 3px solid var(--accent);
  background: var(--accent-soft);
  box-shadow: none;
}

.md-typeset .md-button {
  border-radius: var(--radius);
  border-color: var(--line);
  background: var(--control);
  color: var(--ink);
  font-weight: 600;
}

.md-typeset .md-button--primary {
  background: var(--cta);
  border-color: var(--cta);
  color: var(--cta-ink);
}

.md-typeset img {
  border-radius: var(--radius);
  border: 1px solid var(--line);
}

/* Screenshots sit on their own line so the caption under them never wraps beside the image. */
.md-typeset p > img[width] {
  display: block;
  margin-bottom: 0.4em;
}

.md-typeset code {
  background: var(--accent-soft);
  border-radius: 6px;
}

.md-typeset .highlight,
.md-typeset pre:not(.highlight) {
  background: var(--bg-mid);
  border: 1px solid var(--line);
  border-radius: var(--radius);
  box-shadow: none;
}

.md-typeset table:not([class]) {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  background: var(--panel);
}

.md-typeset table:not([class]) th {
  background: var(--bg-mid);
  color: var(--ink);
}

.md-header__source,
.md-nav__source,
.md-header__option {
  display: none;
}

.yg-site-footer {
  width: min(1280px, calc(100% - 32px));
  max-width: 1280px;
  margin: 32px auto 0;
  padding: 20px 0 40px;
  border-top: 1px solid var(--line);
  color: var(--ink-tertiary);
  font-size: 14.08px;
}

@media (min-width: 1600px) {
  .yg-site-footer {
    width: min(1440px, calc(100% - 48px));
    max-width: 1440px;
  }
}

.yg-site-footer .yg-docs-pager {
  margin-bottom: 20px;
}

.yg-site-footer a {
  color: var(--link, var(--accent));
}

.md-footer {
  display: none;
}

.md-top {
  border-radius: 8px;
}

@media screen and (max-width: 1219px) {
  .md-sidebar--secondary {
    display: none;
  }
}

@media screen and (min-width: 1220px) {
  .md-sidebar--primary {
    width: 11rem;
  }

  .md-sidebar--secondary {
    width: 9.75rem;
  }

  .md-grid {
    max-width: 64rem;
  }

  .md-nav--primary > .md-nav__title {
    display: none;
  }
}

/* Narrow phones: tighter table cells so short tables fit without sideways scrolling. */
@media screen and (max-width: 479px) {
  .md-typeset table:not([class]) th,
  .md-typeset table:not([class]) td {
    padding: 0.6em 0.55em;
  }
  .md-typeset table:not([class]) th {
    min-width: 0;
  }
}

/* Mobile docs content: full-bleed article, flatter cards, readable images */
@media screen and (max-width: 640px) {
  .yg-docs-topbar {
    width: calc(100% - 16px);
    min-height: 56px;
    max-height: 64px;
    height: 56px;
    margin-bottom: 12px;
    padding: 4px 0;
  }

  .md-content__inner {
    background: transparent;
    border: none;
    border-radius: 0;
    /* 0.6rem @ Material 20px root ≈ 12px side gutter */
    margin-left: 0;
    margin-right: 0;
    padding: 0 0.6rem;
    margin-top: 0;
    margin-bottom: 0.5rem;
    box-shadow: none;
  }

  .md-typeset h1 {
    margin-bottom: 0.6em;
  }

  .md-typeset .grid.cards {
    display: grid;
    grid-template-columns: 1fr;
    gap: 0.75rem;
  }

  .md-typeset .grid.cards > ol,
  .md-typeset .grid.cards > ul {
    display: contents;
  }

  .md-typeset .grid.cards > ol > li,
  .md-typeset .grid.cards > ul > li,
  .md-typeset .grid.cards .card {
    border: none;
    border-radius: 0;
    box-shadow: none;
    background: transparent;
    padding: 0.65rem 0;
    border-bottom: 1px solid var(--line);
  }

  .md-typeset img {
    width: 100%;
    max-width: 100%;
    height: auto;
    border-radius: 8px;
  }

  .md-typeset p > img[width] {
    width: 100%;
    max-width: 100%;
  }

  /* Material bleeds tables -0.8rem past the content on phones; keep them inside the 12px gutter */
  .md-typeset .md-typeset__scrollwrap {
    margin-left: 0;
    margin-right: 0;
  }

  .md-typeset .md-typeset__table {
    padding-left: 0;
    padding-right: 0;
    max-width: 100%;
  }
}

@media screen and (max-width: 479px) {
  .yg-docs-topbar {
    width: calc(100% - 12px);
  }
}

/* Accessibility: in-text links are underlined (WCAG 1.4.1), screen-reader-only labels */
.md-typeset p a:not(.md-button),
.md-typeset li a:not(.md-button),
.md-typeset td a:not(.md-button),
.yg-site-footer p a {
  text-decoration: underline;
  text-decoration-thickness: 1px;
  text-underline-offset: 0.15em;
}

.yg-sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}

/* Pager "Previous / Next" labels: full-opacity tertiary ink for AA contrast */
.yg-docs-pager .md-footer__direction {
  color: var(--ink-tertiary);
  opacity: 1;
}
