/* Project Succession Documentation */

.ps-docs {
  max-width: var(--max-width);
  margin: 0 auto;
  padding: var(--spacing-md);
}

.ps-docs-shell {
  display: grid;
  grid-template-columns: 260px minmax(0, 1fr);
  gap: var(--spacing-lg);
  align-items: start;
}

/* ── Sidebar ── */

.ps-docs-sidebar {
  position: sticky;
  top: var(--spacing-md);
  display: flex;
  flex-direction: column;
  max-height: calc(100vh - var(--spacing-lg));
}

/* The search box stays put; only the link list below it scrolls. */
.ps-docs-search-wrapper {
  position: relative;
  z-index: 10;
  flex-shrink: 0;
  padding: var(--spacing-sm) var(--spacing-sm) var(--spacing-md);
}

.ps-docs-search {
  width: 100%;
  padding: var(--spacing-sm) var(--spacing-md);
  background: var(--color-dark);
  border: 1px solid var(--color-border);
  border-radius: 8px;
  color: var(--color-light);
  font-family: var(--font-primary);
  font-size: 14px;
}

.ps-docs-search:focus {
  outline: none;
  border-color: var(--color-primary);
}

.ps-docs-search::placeholder {
  color: var(--color-gray);
}

.ps-docs-search-status {
  margin: var(--spacing-xs) 0 calc(var(--spacing-xs) * -1);
  color: var(--color-gray);
  font-size: 13px;
}

.ps-docs-results {
  position: absolute;
  z-index: 20;
  top: calc(100% - var(--spacing-sm));
  left: var(--spacing-sm);
  right: var(--spacing-sm);
  max-height: 60vh;
  overflow-y: auto;
  margin: 0;
  padding: var(--spacing-xs);
  list-style: none;
  background: var(--color-dark);
  border: 1px solid var(--color-border);
  border-radius: 8px;
  box-shadow: 0 12px 32px rgba(0, 0, 0, 0.55);
}

.ps-docs-result-item a {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: var(--spacing-sm);
  border-radius: 6px;
  text-decoration: none;
}

.ps-docs-result-item.active a,
.ps-docs-result-item a:hover,
.ps-docs-result-item a:focus {
  background: var(--color-bg);
}

.ps-docs-result-name {
  color: var(--color-light);
  font-size: 14px;
  font-weight: 600;
}

.ps-docs-result-meta {
  color: var(--color-gray);
  font-size: 12px;
  text-transform: capitalize;
}

.ps-docs-result-empty {
  padding: var(--spacing-sm);
  color: var(--color-gray);
  font-size: 14px;
}

/* ── Sidebar navigation ── */

/*
 * header.css styles the bare `nav` element - including justify-content: flex-end
 * and align-self: flex-end - so every nav on the page inherits the site header's
 * layout. The docs navs opt back out.
 */
.ps-docs-nav,
.ps-docs-crumbs,
.ps-docs-catnav {
  align-self: stretch;
  justify-content: flex-start;
  width: 100%;
}

.ps-docs-nav {
  display: flex;
  flex-direction: column;
  /* header.css sets align-items: center, which in a column nav centres every link. */
  align-items: stretch;
  min-height: 0;
  overflow-y: auto;
  padding: 0 var(--spacing-sm);
}

.ps-docs-nav a {
  display: flex;
  align-items: baseline;
  justify-content: space-between;
  gap: var(--spacing-sm);
  padding: 6px var(--spacing-sm);
  border-left: 2px solid transparent;
  color: var(--color-gray);
  font-size: 14px;
  text-decoration: none;
  transition: color 0.15s ease, border-color 0.15s ease;
}

.ps-docs-nav a:hover,
.ps-docs-nav a:focus {
  color: var(--color-accent);
}

.ps-docs-nav a.active {
  border-left-color: var(--color-primary);
  color: var(--color-primary);
  font-weight: 600;
}

/* header.css draws an underline under any active nav link; the left bar is the
   only marker this sidebar wants. */
.ps-docs-nav a.active::after {
  content: none;
}

/* ...and its mobile rule centres and full-widths every nav link. */
@media (max-width: 768px) {
  .ps-docs-nav a,
  .ps-docs-crumbs a,
  .ps-docs-catnav a {
    width: auto;
    text-align: left;
  }
}

.ps-docs-nav-heading {
  margin: var(--spacing-md) 0 var(--spacing-xs);
  padding-left: var(--spacing-sm);
  color: var(--color-gray);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
}

.ps-docs-count {
  color: var(--color-gray);
  font-size: 12px;
  font-variant-numeric: tabular-nums;
}

/* ── Content ── */

.ps-docs-content {
  min-width: 0;
}

/* global.css centres every h1 and h2; documentation reads left-aligned. */
.ps-docs-content h1,
.ps-docs-content h2,
.ps-docs-content h3,
.ps-docs-prose h1,
.ps-docs-prose h2,
.ps-docs-prose h3,
.ps-docs-prose h4 {
  text-align: left;
}

.ps-docs-content h1 {
  margin: 0 0 var(--spacing-sm);
  color: var(--color-light);
  font-size: 2rem;
  line-height: 1.2;
}

.ps-docs-content h2 {
  margin: 0 0 var(--spacing-md);
  color: var(--color-light);
  font-size: 1.25rem;
}

.ps-docs-intro {
  margin: 0 0 var(--spacing-lg);
  max-width: 70ch;
  color: var(--color-gray);
  font-size: 1.05rem;
  line-height: 1.7;
}

.ps-docs-crumbs {
  display: flex;
  flex-wrap: wrap;
  gap: var(--spacing-xs);
  margin-bottom: var(--spacing-md);
  color: var(--color-gray);
  font-size: 13px;
}

.ps-docs-crumbs a {
  color: var(--color-gray);
  text-decoration: none;
}

.ps-docs-crumbs a:hover {
  color: var(--color-accent);
}

.ps-docs-section {
  margin-bottom: var(--spacing-lg);
  scroll-margin-top: var(--spacing-md);
}

/* ── Landing ── */

.ps-docs-stats {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(160px, 1fr));
  gap: var(--spacing-md);
  margin-bottom: var(--spacing-lg);
}

.ps-docs-stat {
  display: flex;
  flex-direction: column;
  gap: 2px;
  padding: var(--spacing-md);
  background: var(--color-dark);
  border: 1px solid var(--color-border);
  border-radius: 10px;
  text-decoration: none;
  transition: border-color 0.2s ease, transform 0.2s ease;
}

.ps-docs-stat:hover {
  border-color: var(--color-primary);
  transform: translateY(-2px);
}

.ps-docs-stat-num {
  color: var(--color-primary);
  font-size: 2rem;
  font-weight: 700;
  line-height: 1;
}

.ps-docs-stat-label {
  color: var(--color-light);
  font-weight: 600;
}

.ps-docs-stat-sub {
  color: var(--color-gray);
  font-size: 13px;
}

.ps-docs-chips {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(150px, 1fr));
  gap: 2px var(--spacing-md);
  margin: 0;
  padding: 0;
  list-style: none;
}

.ps-docs-chip {
  padding: 5px 0;
  border-bottom: 1px solid var(--color-border);
  color: var(--color-gray);
  font-size: 14px;
}

/* The category beside a node's kind - a small tag, distinct from the list rows above. */
.ps-docs-node-category {
  padding: 2px 7px;
  background: var(--color-bg);
  border: 1px solid var(--color-border);
  border-radius: 3px;
  color: var(--color-gray);
  font-size: 12px;
}

/* ── Category navigation and cards ── */

.ps-docs-catnav {
  display: flex;
  flex-wrap: wrap;
  gap: 4px var(--spacing-md);
  margin-bottom: var(--spacing-lg);
  padding-bottom: var(--spacing-md);
  border-bottom: 1px solid var(--color-border);
}

.ps-docs-catnav a {
  display: inline-flex;
  align-items: baseline;
  gap: 5px;
  padding: 3px 0;
  border-bottom: 1px solid transparent;
  color: var(--color-gray);
  font-size: 14px;
  text-decoration: none;
  transition: color 0.15s ease, border-color 0.15s ease;
}

.ps-docs-catnav a:hover,
.ps-docs-catnav a:focus-visible {
  border-bottom-color: var(--color-primary);
  color: var(--color-primary);
}

.ps-docs-cards {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: var(--spacing-sm);
  margin: 0;
  padding: 0;
  list-style: none;
}

.ps-docs-card {
  display: flex;
  flex-direction: column;
  gap: var(--spacing-xs);
  height: 100%;
  padding: var(--spacing-md);
  background: var(--color-dark);
  border: 1px solid var(--color-border);
  border-radius: 10px;
  text-decoration: none;
  transition: border-color 0.2s ease, transform 0.2s ease;
}

.ps-docs-card:hover {
  border-color: var(--color-primary);
  transform: translateY(-2px);
}

.ps-docs-card-name {
  color: var(--color-light);
  font-weight: 600;
}

.ps-docs-card-desc {
  color: var(--color-gray);
  font-size: 13px;
  line-height: 1.5;
}

/* ── Node page ── */

.ps-docs-node-head {
  margin-bottom: var(--spacing-lg);
}

.ps-docs-node-kind {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  margin: 0 0 var(--spacing-sm);
  font-size: 13px;
}

.ps-docs-node-kind a {
  color: var(--color-primary);
  text-decoration: none;
}

.ps-docs-node-desc {
  margin: 0 0 var(--spacing-md);
  max-width: 70ch;
  color: var(--color-gray);
  font-size: 1.05rem;
  line-height: 1.7;
}

.ps-docs-node-id {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
  margin: 0;
  color: var(--color-gray);
  font-size: 12px;
  text-transform: uppercase;
  letter-spacing: 0.06em;
}

.ps-docs-none {
  margin: 0;
  padding: var(--spacing-md);
  background: var(--color-dark);
  border: 1px dashed var(--color-border);
  border-radius: 8px;
  color: var(--color-gray);
}

.ps-docs-note {
  margin: var(--spacing-sm) 0 0;
  color: var(--color-gray);
  font-size: 13px;
}

.ps-docs-dash {
  color: var(--color-border);
}

/* ── Tables ── */

.ps-docs-table-scroll {
  overflow-x: auto;
  border: 1px solid var(--color-border);
  border-radius: 10px;
}

.ps-docs-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 14px;
}

.ps-docs-table th {
  padding: var(--spacing-sm) var(--spacing-md);
  background: var(--color-dark);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-gray);
  font-size: 11px;
  font-weight: 700;
  letter-spacing: 0.06em;
  text-align: left;
  text-transform: uppercase;
  white-space: nowrap;
}

.ps-docs-table td {
  padding: var(--spacing-sm) var(--spacing-md);
  border-bottom: 1px solid var(--color-border);
  color: var(--color-gray);
  line-height: 1.6;
  vertical-align: top;
}

.ps-docs-table tr:last-child td {
  border-bottom: none;
}

.ps-docs-label {
  display: block;
  color: var(--color-light);
  font-weight: 600;
}

.ps-docs-name {
  display: block;
  margin-top: 2px;
}

.ps-docs-options {
  margin: var(--spacing-xs) 0 0;
  padding: 0;
  max-height: 11rem;
  overflow-y: auto;
  list-style: none;
  display: flex;
  flex-wrap: wrap;
  gap: 4px;
}

.ps-docs-range {
  display: block;
  margin-top: 4px;
  font-size: 12px;
}

/* Type names are short tokens; breaking them mid-word ("textare a") reads badly. */
.ps-docs-table td > code {
  white-space: nowrap;
}

.ps-docs code {
  padding: 2px 6px;
  background: var(--color-bg);
  border-radius: 4px;
  color: var(--color-accent);
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.85em;
  overflow-wrap: anywhere;
}

/* ── Guide prose ── */

.ps-docs-prose {
  max-width: 75ch;
  color: var(--color-gray);
  line-height: 1.75;
}

.ps-docs-prose h1,
.ps-docs-prose h2,
.ps-docs-prose h3,
.ps-docs-prose h4 {
  margin: var(--spacing-lg) 0 var(--spacing-sm);
  color: var(--color-light);
  line-height: 1.3;
}

.ps-docs-prose h1 {
  margin-top: 0;
  font-size: 2rem;
}

.ps-docs-prose h2 {
  font-size: 1.4rem;
  padding-bottom: var(--spacing-xs);
  border-bottom: 1px solid var(--color-border);
}

.ps-docs-prose h3 { font-size: 1.15rem; }

.ps-docs-prose a {
  color: var(--color-accent);
}

.ps-docs-prose ul,
.ps-docs-prose ol {
  padding-left: var(--spacing-md);
}

.ps-docs-prose li {
  margin-bottom: var(--spacing-xs);
}

.ps-docs-prose img {
  display: block;
  max-width: 100%;
  height: auto;
  margin: var(--spacing-md) 0;
  border: 1px solid var(--color-border);
  border-radius: 8px;
}

.ps-docs-prose pre {
  overflow-x: auto;
  margin: var(--spacing-md) 0;
  padding: var(--spacing-md);
  background: var(--color-darker);
  border: 1px solid var(--color-border);
  border-radius: 8px;
}

.ps-docs-prose pre code {
  padding: 0;
  background: none;
  color: var(--color-gray-light);
}

.ps-docs-prose blockquote {
  margin: var(--spacing-md) 0;
  padding: var(--spacing-sm) var(--spacing-md);
  border-left: 3px solid var(--color-primary);
  background: var(--color-dark);
  border-radius: 0 8px 8px 0;
}

.ps-docs-prose table {
  width: 100%;
  margin: var(--spacing-md) 0;
  border-collapse: collapse;
  font-size: 14px;
}

.ps-docs-prose th,
.ps-docs-prose td {
  padding: var(--spacing-sm);
  border: 1px solid var(--color-border);
  text-align: left;
}

.ps-docs-prose th {
  background: var(--color-dark);
  color: var(--color-light);
}

/* ── Responsive ── */

@media (max-width: 900px) {
  .ps-docs-shell {
    grid-template-columns: minmax(0, 1fr);
    gap: var(--spacing-md);
  }

  .ps-docs-sidebar {
    position: static;
    max-height: none;
  }

  .ps-docs-nav {
    overflow-y: visible;
  }

  .ps-docs-nav {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(180px, 1fr));
  }

  .ps-docs-nav-heading {
    grid-column: 1 / -1;
  }
}