/* ============================================================
   BookDinePlay Developer Docs — shell + prose.
   Builds on the tokens in site.css; no third-party CSS.
   ============================================================ */

/* The shell root sits inside `.container` (site.css owns the max-width/padding), so it only
   needs its own grid. */
.docs {
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 220px;
  gap: 3rem;
  padding-block: 2.5rem 5rem;
  align-items: start;
}

/* ---------- Left: section nav ---------- */

.docs-nav {
  position: sticky;
  top: 5.5rem;
  max-height: calc(100vh - 6.5rem);
  overflow-y: auto;
  font-size: 0.93rem;
}

.docs-nav__summary {
  display: none;
  cursor: pointer;
  font-weight: 600;
  padding: 0.6rem 0;
  list-style: none;
}

.docs-nav__summary::-webkit-details-marker {
  display: none;
}

.docs-nav__group + .docs-nav__group {
  margin-top: 1.5rem;
}

.docs-nav__group-title {
  margin: 0 0 0.4rem;
  font-family: var(--font-display);
  font-size: 0.78rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
}

.docs-nav__group-title a {
  color: inherit;
  text-decoration: none;
}

.docs-nav li a {
  display: block;
  padding: 0.35rem 0.6rem;
  margin-left: -0.6rem;
  border-radius: var(--radius-sm);
  color: var(--ink);
  text-decoration: none;
}

.docs-nav li a:hover {
  background: var(--chalk);
}

.docs-nav li a.is-active {
  background: var(--chalk);
  color: var(--ember-strong);
  font-weight: 600;
}

/* ---------- Centre: article ---------- */

.docs-article {
  min-width: 0;
  max-width: 76ch;
}

.docs-article__head {
  margin-bottom: 2rem;
  padding-bottom: 1.5rem;
  border-bottom: 1px solid var(--line);
}

.docs-article__title {
  margin: 0.25rem 0 0.5rem;
  font-family: var(--font-display);
  font-size: clamp(1.9rem, 3.4vw, 2.6rem);
  line-height: 1.1;
  letter-spacing: -0.01em;
}

.docs-article__head .lede {
  margin: 0;
  color: var(--muted);
}

.docs-article h2 {
  margin: 2.5rem 0 0.75rem;
  font-family: var(--font-display);
  font-size: 1.45rem;
  line-height: 1.2;
  scroll-margin-top: 5.5rem;
}

.docs-article h3 {
  margin: 1.8rem 0 0.5rem;
  font-size: 1.12rem;
  scroll-margin-top: 5.5rem;
}

.docs-article h4 {
  margin: 1.4rem 0 0.4rem;
  font-size: 1rem;
}

.docs-article p,
.docs-article li {
  line-height: 1.7;
}

.docs-article p {
  margin: 0 0 1rem;
}

.docs-article ul,
.docs-article ol {
  margin: 0 0 1rem 1.4rem;
  padding: 0;
}

.docs-article ul {
  list-style: disc;
}

.docs-article ol {
  list-style: decimal;
}

.docs-article li + li {
  margin-top: 0.3rem;
}

.docs-article a {
  color: var(--ember-strong);
  text-underline-offset: 0.15em;
}

.docs-article code {
  font-family: "Cascadia Mono", "Consolas", "SFMono-Regular", Menlo, monospace;
  font-size: 0.88em;
}

.docs-article :not(pre) > code {
  background: var(--chalk);
  border: 1px solid var(--line);
  border-radius: 5px;
  padding: 0.08em 0.35em;
}

.docs-article table {
  width: 100%;
  border-collapse: collapse;
  margin: 0 0 1.25rem;
  font-size: 0.93rem;
}

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

.docs-article th {
  font-weight: 600;
  background: var(--chalk-2);
}

.docs-article .code-block {
  position: relative;
  margin: 0 0 1.25rem;
}

/* ---------- Copy button (added by docs.js) ---------- */

.docs-copy {
  position: absolute;
  top: 0.55rem;
  right: 0.55rem;
  border: 1px solid var(--line-dark);
  background: rgba(20, 18, 16, 0.85);
  color: var(--muted-on-dark);
  font: inherit;
  font-size: 0.75rem;
  padding: 0.25rem 0.55rem;
  border-radius: 6px;
  cursor: pointer;
}

.docs-copy:hover,
.docs-copy:focus-visible {
  color: var(--chalk);
  border-color: var(--ember);
}

.docs-copy:focus-visible {
  outline: 2px solid var(--ember);
  outline-offset: 2px;
}

/* ---------- Callouts ---------- */

.docs-callout {
  margin: 0 0 1.25rem;
  padding: 0.9rem 1.1rem;
  border-left: 4px solid var(--baize);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  background: var(--chalk-2);
}

.docs-callout__label {
  margin: 0 0 0.3rem;
  font-family: var(--font-display);
  font-size: 0.78rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--baize-strong);
}

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

.docs-callout--warning {
  border-left-color: var(--ember);
}

.docs-callout--warning .docs-callout__label {
  color: var(--ember-strong);
}

.docs-callout--security {
  border-left-color: var(--ink);
  background: var(--chalk);
}

.docs-callout--security .docs-callout__label {
  color: var(--ink);
}

/* ---------- Tabs ---------- */

.docs-tabs {
  margin: 0 0 1.25rem;
}

.docs-tab__label {
  margin: 0 0 0.4rem;
  font-size: 0.85rem;
  color: var(--muted);
}

.docs-tabs.is-enhanced .docs-tab__label {
  display: none;
}

.docs-tabs.is-enhanced .docs-tab[hidden] {
  display: none;
}

.docs-tabs__list {
  display: flex;
  gap: 0.25rem;
  margin: 0;
  padding: 0;
  border-bottom: 1px solid var(--line);
}

.docs-tabs__tab {
  border: 0;
  border-bottom: 2px solid transparent;
  background: none;
  font: inherit;
  font-size: 0.88rem;
  padding: 0.5rem 0.8rem;
  color: var(--muted);
  cursor: pointer;
}

.docs-tabs__tab[aria-selected="true"] {
  color: var(--ink);
  border-bottom-color: var(--ember);
  font-weight: 600;
}

.docs-tabs.is-enhanced .code-block {
  border-top-left-radius: 0;
  border-top-right-radius: 0;
  margin-bottom: 0;
}

/* ---------- Right: outline ---------- */

.docs-outline {
  position: sticky;
  top: 5.5rem;
  font-size: 0.85rem;
}

.docs-outline__title {
  margin: 0 0 0.5rem;
  font-family: var(--font-display);
  font-size: 0.78rem;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--muted);
}

.docs-outline__list {
  margin: 0;
  padding: 0;
  border-left: 1px solid var(--line);
}

.docs-outline__item a {
  display: block;
  padding: 0.25rem 0 0.25rem 0.8rem;
  margin-left: -1px;
  border-left: 2px solid transparent;
  color: var(--muted);
  text-decoration: none;
}

.docs-outline__item--h3 a {
  padding-left: 1.6rem;
}

.docs-outline__item a:hover,
.docs-outline__item a.is-active {
  color: var(--ink);
  border-left-color: var(--ember);
}

/* ---------- Responsive ---------- */

@media (max-width: 1279px) {
  .docs {
    grid-template-columns: 240px minmax(0, 1fr);
  }

  .docs-outline {
    display: none;
  }
}

@media (max-width: 1023px) {
  .docs {
    grid-template-columns: minmax(0, 1fr);
    gap: 1.5rem;
  }

  .docs-nav {
    position: static;
    max-height: none;
    overflow: visible;
    border: 1px solid var(--line);
    border-radius: var(--radius-sm);
    padding: 0 1rem;
  }

  .docs-nav__summary {
    display: block;
  }

  .docs-nav__drawer:not([open]) .docs-nav__group {
    display: none;
  }

  .docs-nav__group:last-child {
    padding-bottom: 1rem;
  }
}

/* ---------- Session strip (login + personalization) ---------- */

.docs-session {
  margin: 0 0 1.25rem;
  padding: 0.7rem 1rem;
  border: 1px solid var(--line);
  border-radius: var(--radius-sm);
  background: var(--chalk-2);
  font-size: 0.9rem;
}

.docs-session p {
  margin: 0;
  line-height: 1.6;
}

.docs-session a {
  color: var(--ember-strong);
  font-weight: 600;
}

.docs-session[hidden],
.docs-session p[hidden] {
  display: none;
}

/* A swapped token is the operator's real value; mark it so the eye finds it. */
[data-bdp-token].is-personal {
  text-decoration: underline dotted var(--baize);
  text-underline-offset: 0.2em;
}