/* ==========================================================================
   Documentation hub (/documentation) — extends the Tally system
   ========================================================================== */

.docs-page {
  padding: calc(var(--nav-height) + var(--space-2xl)) 0 var(--space-4xl);
  min-height: 80vh;
}

.docs-hero {
  margin-bottom: var(--space-2xl);
  padding-bottom: var(--space-xl);
  border-bottom: var(--rule-hair);
}
.docs-hero__title {
  font-family: var(--font-display);
  font-size: var(--text-4xl);
  letter-spacing: -0.02em;
  margin: var(--space-xs) 0;
  color: var(--color-ink-0);
}
.docs-hero__sub {
  color: var(--color-ink-2);
  font-size: var(--text-lg);
  margin: 0;
}

.docs-shell {
  display: grid;
  grid-template-columns: 220px minmax(0, 1fr);
  gap: var(--space-xl);
  align-items: start;
}
/* The right-hand mini TOC only claims a column when the page has headings —
   otherwise the article runs to the container's right edge like the hero. */
.docs-shell.has-toc { grid-template-columns: 220px minmax(0, 1fr) 170px; }
.docs-shell:not(.has-toc) .docs-toc { display: none; }

/* ---------- Sidebar tree ---------- */
.docs-nav-toggle { display: none; }
.docs-sidebar {
  position: sticky;
  top: calc(var(--nav-height) + var(--space-lg));
  max-height: calc(100vh - var(--nav-height) - var(--space-2xl));
  overflow-y: auto;
  padding-right: var(--space-xs);
}
.docs-tree__list {
  list-style: none;
  margin: 0;
  padding: 0;
}
.docs-tree__list .docs-tree__list {
  padding-left: var(--space-md);
  border-left: var(--rule-hair);
  margin-left: 7px;
}
.docs-tree__branch {
  display: flex;
  align-items: center;
  gap: 2px;
}
.docs-tree__toggle {
  border: 0;
  background: none;
  cursor: pointer;
  color: var(--color-ink-3);
  width: 18px;
  height: 18px;
  display: grid;
  place-items: center;
  flex-shrink: 0;
  border-radius: var(--radius-sm);
}
.docs-tree__toggle svg {
  width: 9px;
  height: 9px;
  transition: transform var(--dur-fast) var(--ease-out);
}
.docs-tree__toggle[aria-expanded="true"] svg { transform: rotate(90deg); }
.docs-tree__link {
  display: block;
  flex: 1;
  padding: 6px 10px;
  border-radius: var(--radius-sm);
  color: var(--color-ink-2);
  text-decoration: none;
  font-size: var(--text-sm);
  line-height: 1.4;
}
.docs-tree__link:hover {
  color: var(--color-ink-0);
  background: var(--color-paper-1);
}
.docs-tree__link.is-active {
  color: var(--color-accent);
  background: var(--color-accent-tint);
  font-weight: 550;
}

/* ---------- Article ---------- */
.docs-article { min-width: 0; }
.docs-breadcrumbs {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2xs);
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: var(--color-ink-3);
  margin-bottom: var(--space-lg);
}
.docs-breadcrumbs a { color: var(--color-ink-2); text-decoration: none; }
.docs-breadcrumbs a:hover { color: var(--color-accent); }
.docs-breadcrumbs__sep { color: var(--color-ink-3); }
.docs-fallback-note {
  background: var(--color-paper-1);
  border: var(--rule-hair);
  border-radius: var(--radius-sm);
  padding: var(--space-sm) var(--space-md);
  font-size: var(--text-sm);
  color: var(--color-ink-2);
  margin-bottom: var(--space-lg);
}
.docs-loading { color: var(--color-ink-2); }

.doc-content { line-height: 1.7; color: var(--color-ink-1); }
.doc-content h1 {
  font-family: var(--font-display);
  font-size: var(--text-3xl);
  letter-spacing: -0.02em;
  color: var(--color-ink-0);
  margin: 0 0 var(--space-lg);
}
.doc-content h2 {
  font-size: var(--text-xl);
  color: var(--color-ink-0);
  margin: var(--space-2xl) 0 var(--space-sm);
  padding-top: var(--space-sm);
  scroll-margin-top: calc(var(--nav-height) + var(--space-lg));
}
.doc-content h3 {
  font-size: var(--text-lg);
  color: var(--color-ink-0);
  margin: var(--space-xl) 0 var(--space-xs);
  scroll-margin-top: calc(var(--nav-height) + var(--space-lg));
}
.doc-content p { margin: 0 0 var(--space-md); }
/* Colour and underline come from the inline-link block in pages.css. */
.doc-content img {
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-md);
  border: var(--rule-hair);
  margin: var(--space-md) 0;
}
.doc-content code {
  font-family: var(--font-mono);
  font-size: 0.88em;
  background: var(--color-paper-1);
  border-radius: 4px;
  padding: 1px 6px;
}
.doc-content pre {
  background: var(--color-paper-1);
  border: var(--rule-hair);
  border-radius: var(--radius-md);
  padding: var(--space-md) var(--space-lg);
  overflow-x: auto;
  margin: var(--space-md) 0;
}
.doc-content pre code { background: none; padding: 0; }
.doc-content blockquote {
  border-left: 3px solid var(--color-accent);
  margin: var(--space-md) 0;
  padding: var(--space-2xs) var(--space-lg);
  color: var(--color-ink-2);
}
.doc-content ul, .doc-content ol { padding-left: 1.4em; margin: 0 0 var(--space-md); }
.doc-content li { margin-bottom: var(--space-2xs); }
.doc-content table {
  width: 100%;
  border-collapse: collapse;
  font-size: var(--text-sm);
  margin: var(--space-md) 0;
  display: block;
  overflow-x: auto;
}
.doc-content th, .doc-content td {
  border: var(--rule-hair);
  padding: var(--space-xs) var(--space-sm);
  text-align: left;
}
.doc-content th {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-ink-2);
  background: var(--color-paper-1);
}
.doc-content hr { border: 0; border-top: var(--rule-hair); margin: var(--space-xl) 0; }

.docs-article-footer {
  margin-top: var(--space-2xl);
  padding-top: var(--space-lg);
  border-top: var(--rule-hair);
}
.docs-updated {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: var(--color-ink-3);
}
.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: var(--space-md);
  margin-top: var(--space-md);
}
.docs-pager__link {
  display: flex;
  flex-direction: column;
  gap: 2px;
  text-decoration: none;
  border: var(--rule-hair);
  border-radius: var(--radius-md);
  padding: var(--space-sm) var(--space-lg);
  max-width: 46%;
}
.docs-pager__link:hover { border-color: var(--color-accent); }
.docs-pager__link--next { text-align: right; margin-left: auto; }
.docs-pager__dir {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  color: var(--color-ink-3);
}
.docs-pager__title { color: var(--color-accent); font-size: var(--text-sm); }

/* ---------- Right-hand mini TOC ---------- */
.docs-toc {
  position: sticky;
  top: calc(var(--nav-height) + var(--space-lg));
  font-size: var(--text-sm);
}
.docs-toc__title {
  font-family: var(--font-mono);
  font-size: var(--text-xs);
  text-transform: uppercase;
  letter-spacing: 0.1em;
  color: var(--color-ink-3);
  margin: 0 0 var(--space-xs);
}
.docs-toc__list { list-style: none; margin: 0; padding: 0; }
.docs-toc__item { margin: 0 0 var(--space-2xs); }
.docs-toc__item--h3 { padding-left: var(--space-md); }
.docs-toc__item a { color: var(--color-ink-2); text-decoration: none; }
.docs-toc__item a:hover { color: var(--color-accent); }

/* ---------- Responsive ---------- */
@media (max-width: 1100px) {
  .docs-shell, .docs-shell.has-toc { grid-template-columns: 220px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 820px) {
  .docs-shell { grid-template-columns: 1fr; gap: var(--space-md); }
  .docs-nav-toggle {
    display: inline-flex;
    align-items: center;
    gap: var(--space-xs);
    border: var(--rule-hair);
    background: var(--color-paper-1);
    color: var(--color-ink-1);
    border-radius: var(--radius-pill);
    padding: var(--space-xs) var(--space-lg);
    cursor: pointer;
    font-size: var(--text-sm);
    width: fit-content;
  }
  .docs-sidebar {
    display: none;
    position: static;
    max-height: none;
    border: var(--rule-hair);
    border-radius: var(--radius-md);
    padding: var(--space-sm);
    background: var(--color-paper-1);
  }
  .docs-sidebar.is-open { display: block; }
}