/* =====================================================
   VOXSTR DOCS - Shared docs-only styles

   Imported AFTER /styles.css so it inherits all design
   tokens (--bg-primary, --text-primary, etc.) and fonts.
   Only contains rules that are specific to the docs
   surface (article typography, TOC, breadcrumb, etc.).
   ===================================================== */

/* -----------------------------------------------------
   DOCS LAYOUT
   ----------------------------------------------------- */

.docs-page {
  background-color: var(--bg-primary);
  color: var(--text-primary);
  min-height: 100vh;
}

.docs-container {
  max-width: 48rem; /* ~768px — comfortable reading width */
  margin: 0 auto;
  padding: 8rem 1.5rem 4rem;
}

/* -----------------------------------------------------
   BREADCRUMB
   ----------------------------------------------------- */

.docs-breadcrumb {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  font-size: 0.875rem;
  color: var(--text-tertiary);
  margin-bottom: 1.5rem;
  flex-wrap: wrap;
}

.docs-breadcrumb a {
  color: var(--text-secondary);
  text-decoration: none;
  transition: color 0.2s ease;
}

.docs-breadcrumb a:hover {
  color: var(--text-primary);
}

.docs-breadcrumb .sep {
  color: var(--text-tertiary);
  opacity: 0.5;
}

.docs-breadcrumb .current {
  color: var(--text-primary);
}

/* -----------------------------------------------------
   ARTICLE TYPOGRAPHY
   ----------------------------------------------------- */

.docs-title {
  font-size: clamp(2rem, 4vw, 3rem);
  font-weight: 800;
  letter-spacing: -0.025em;
  line-height: 1.1;
  color: var(--text-primary);
  margin-bottom: 0.75rem;
}

.docs-meta {
  font-size: 0.875rem;
  color: var(--text-tertiary);
  margin-bottom: 2.5rem;
  display: flex;
  align-items: center;
  gap: 0.75rem;
  flex-wrap: wrap;
}

.docs-meta .dot {
  opacity: 0.5;
}

.docs-lead {
  font-size: 1.125rem;
  line-height: 1.7;
  color: var(--text-secondary);
  margin-bottom: 2rem;
}

.docs-body {
  font-size: 1rem;
  line-height: 1.75;
  color: var(--text-primary);
}

.docs-body h2 {
  font-size: 1.5rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  margin-top: 3rem;
  margin-bottom: 1rem;
  color: var(--text-primary);
  scroll-margin-top: 6rem;
}

.docs-body h3 {
  font-size: 1.2rem;
  font-weight: 600;
  margin-top: 2rem;
  margin-bottom: 0.75rem;
  color: var(--text-primary);
  scroll-margin-top: 6rem;
}

.docs-body p {
  margin-bottom: 1.25rem;
  color: var(--text-secondary);
}

.docs-body a {
  color: var(--text-primary);
  text-decoration: underline;
  text-decoration-color: var(--border-primary);
  text-underline-offset: 3px;
  transition: text-decoration-color 0.2s ease;
}

.docs-body a:hover {
  text-decoration-color: var(--text-primary);
}

.docs-body ul,
.docs-body ol {
  padding-left: 1.5rem;
  margin-bottom: 1.25rem;
  color: var(--text-secondary);
}

.docs-body ul li,
.docs-body ol li {
  margin-bottom: 0.5rem;
}

.docs-body code {
  font-family: 'SF Mono', 'Fira Code', 'Cascadia Code', monospace;
  font-size: 0.875em;
  padding: 0.15em 0.4em;
  border-radius: 4px;
  background: var(--accent-muted);
  border: 1px solid var(--border-subtle);
  color: var(--text-primary);
}

.docs-body pre {
  background: var(--bg-secondary);
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  padding: 1rem 1.25rem;
  overflow-x: auto;
  margin-bottom: 1.5rem;
  font-size: 0.875rem;
  line-height: 1.6;
}

.docs-body pre code {
  background: transparent;
  border: none;
  padding: 0;
  font-size: inherit;
}

.docs-body blockquote {
  border-left: 3px solid var(--border-primary);
  padding-left: 1.25rem;
  margin: 1.5rem 0;
  color: var(--text-secondary);
  font-style: italic;
}

.docs-body img {
  max-width: 100%;
  border-radius: 8px;
  border: 1px solid var(--border-subtle);
  margin: 1.5rem 0;
}

/* -----------------------------------------------------
   TABLE OF CONTENTS (optional slot)
   ----------------------------------------------------- */

.docs-toc {
  border: 1px solid var(--border-subtle);
  background: var(--bg-secondary);
  border-radius: 10px;
  padding: 1rem 1.25rem;
  margin-bottom: 2rem;
}

.docs-toc-title {
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-tertiary);
  margin-bottom: 0.75rem;
}

.docs-toc ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

.docs-toc li {
  margin-bottom: 0.5rem;
}

.docs-toc a {
  color: var(--text-secondary);
  text-decoration: none;
  font-size: 0.9rem;
  transition: color 0.2s ease;
}

.docs-toc a:hover {
  color: var(--text-primary);
}

/* -----------------------------------------------------
   WAS THIS HELPFUL
   ----------------------------------------------------- */

.docs-feedback {
  margin-top: 4rem;
  padding: 1.5rem;
  border: 1px solid var(--border-subtle);
  border-radius: 10px;
  background: var(--bg-secondary);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  flex-wrap: wrap;
}

.docs-feedback-label {
  font-size: 0.9rem;
  color: var(--text-secondary);
  font-weight: 500;
}

.docs-feedback-actions {
  display: flex;
  gap: 0.5rem;
}

.docs-feedback-btn {
  padding: 0.45rem 1rem;
  border-radius: 8px;
  border: 1px solid var(--border-primary);
  background: var(--bg-card);
  color: var(--text-secondary);
  font-size: 0.875rem;
  font-weight: 500;
  cursor: pointer;
  transition: all 0.2s ease;
}

.docs-feedback-btn:hover {
  color: var(--text-primary);
  border-color: var(--text-tertiary);
  background: var(--bg-card-hover);
}

/* -----------------------------------------------------
   PREV / NEXT NAV
   ----------------------------------------------------- */

.docs-prevnext {
  margin-top: 3rem;
  padding-top: 2rem;
  border-top: 1px solid var(--border-subtle);
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
}

.docs-prevnext a {
  display: flex;
  flex-direction: column;
  gap: 0.25rem;
  padding: 1rem 1.25rem;
  border-radius: 10px;
  border: 1px solid var(--border-subtle);
  background: var(--bg-card);
  color: var(--text-primary);
  text-decoration: none;
  transition: all 0.2s ease;
}

.docs-prevnext a:hover {
  border-color: var(--text-tertiary);
  background: var(--bg-card-hover);
}

.docs-prevnext .label {
  font-size: 0.75rem;
  color: var(--text-tertiary);
  text-transform: uppercase;
  letter-spacing: 0.08em;
  font-weight: 600;
}

.docs-prevnext .title {
  font-size: 0.95rem;
  font-weight: 600;
  color: var(--text-primary);
}

.docs-prevnext .next {
  text-align: right;
}

@media (max-width: 600px) {
  .docs-prevnext {
    grid-template-columns: 1fr;
  }
  .docs-prevnext .next {
    text-align: left;
  }
}

/* -----------------------------------------------------
   RELATED ARTICLES
   ----------------------------------------------------- */

.docs-related {
  margin-top: 3rem;
  padding: 1.5rem;
  border: 1px solid var(--border-subtle);
  border-radius: 10px;
  background: var(--bg-secondary);
}

.docs-related-title {
  font-size: 0.75rem;
  font-weight: 600;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-tertiary);
  margin-bottom: 0.75rem;
}

.docs-related ul {
  list-style: none;
  padding-left: 0;
  margin: 0;
}

.docs-related li {
  margin-bottom: 0.85rem;
}

.docs-related li:last-child {
  margin-bottom: 0;
}

.docs-related a {
  color: var(--text-primary);
  text-decoration: none;
  font-size: 0.95rem;
  font-weight: 500;
  transition: color 0.2s ease;
}

.docs-related a:hover {
  color: var(--text-secondary);
}

.docs-related .summary {
  display: block;
  font-size: 0.85rem;
  color: var(--text-tertiary);
  margin-top: 0.15rem;
}

/* -----------------------------------------------------
   INDEX PAGE — article cards
   ----------------------------------------------------- */

.docs-intro {
  margin-bottom: 3rem;
}

.docs-intro h1 {
  font-size: clamp(2.25rem, 4vw, 3rem);
  font-weight: 800;
  letter-spacing: -0.025em;
  line-height: 1.1;
  margin-bottom: 1rem;
  color: var(--text-primary);
}

.docs-intro p {
  font-size: 1.125rem;
  line-height: 1.6;
  color: var(--text-secondary);
  max-width: 42rem;
}

.docs-section {
  margin-bottom: 3rem;
}

.docs-section-title {
  font-size: 0.75rem;
  font-weight: 700;
  letter-spacing: 0.1em;
  text-transform: uppercase;
  color: var(--text-tertiary);
  margin-bottom: 1rem;
}

.docs-article-list {
  display: grid;
  grid-template-columns: 1fr;
  gap: 0.5rem;
}

.docs-article-card {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 1rem;
  padding: 1rem 1.25rem;
  border: 1px solid var(--border-subtle);
  border-radius: 10px;
  background: var(--bg-card);
  color: var(--text-primary);
  text-decoration: none;
  transition: all 0.2s ease;
}

.docs-article-card:hover {
  border-color: var(--text-tertiary);
  background: var(--bg-card-hover);
  transform: translateY(-1px);
}

.docs-article-card.stub {
  opacity: 0.55;
  cursor: not-allowed;
  pointer-events: none;
}

.docs-article-card .card-title {
  font-size: 1rem;
  font-weight: 600;
  color: var(--text-primary);
  margin-bottom: 0.2rem;
}

.docs-article-card .card-desc {
  font-size: 0.875rem;
  color: var(--text-tertiary);
}

.docs-article-card .card-arrow {
  color: var(--text-tertiary);
  flex-shrink: 0;
}

.docs-article-card .stub-badge {
  font-size: 0.7rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.06em;
  padding: 0.25rem 0.55rem;
  border-radius: 5px;
  background: var(--accent-muted);
  color: var(--text-tertiary);
  flex-shrink: 0;
}

/* -----------------------------------------------------
   ARTICLE BODY — TABLES
   ----------------------------------------------------- */

.docs-body table {
  width: 100%;
  border-collapse: collapse;
  margin: 1.5rem 0;
  font-size: 0.9rem;
  border: 1px solid var(--border-subtle);
  border-radius: 8px;
  overflow: hidden;
}

.docs-body thead {
  background: var(--bg-secondary);
}

.docs-body th {
  text-align: left;
  font-weight: 600;
  color: var(--text-primary);
  padding: 0.65rem 0.85rem;
  border-bottom: 1px solid var(--border-subtle);
  font-size: 0.85rem;
}

.docs-body td {
  padding: 0.65rem 0.85rem;
  color: var(--text-secondary);
  border-bottom: 1px solid var(--border-subtle);
  vertical-align: top;
}

.docs-body tbody tr:last-child td {
  border-bottom: none;
}

.docs-body td code,
.docs-body th code {
  font-size: 0.8rem;
  white-space: nowrap;
}

/* -----------------------------------------------------
   CALLOUTS (note / warn / tip)
   ----------------------------------------------------- */

.docs-callout {
  border: 1px solid var(--border-subtle);
  background: var(--bg-secondary);
  border-radius: 10px;
  padding: 1rem 1.25rem;
  margin: 1.5rem 0;
  border-left-width: 3px;
  border-left-color: var(--text-tertiary);
}

.docs-callout-title {
  font-size: 0.75rem;
  font-weight: 700;
  letter-spacing: 0.08em;
  text-transform: uppercase;
  color: var(--text-tertiary);
  margin-bottom: 0.4rem;
}

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

.docs-callout.warn {
  border-left-color: var(--text-secondary);
}