/* ========================================
   V3 DOCS: Documentation Layout & Styles
   PersonaSpec - Dark/Terminal Aesthetic
   ======================================== */

/* ----------------------------------------
   Page Header
   ---------------------------------------- */
.page-header {
  max-width: var(--max-width);
  margin: 0 auto;
  padding: 80px var(--content-padding) 60px;
}

.page-header__title {
  font-size: clamp(2rem, 5vw, 3rem);
  font-weight: 700;
  letter-spacing: -0.03em;
  margin-bottom: 16px;
}

.page-header__subtitle {
  font-size: var(--text-lg);
  color: var(--text-muted);
  max-width: 600px;
  margin: 0;
}

/* ----------------------------------------
   Docs Layout (Sidebar + Content)
   ---------------------------------------- */
.docs-layout {
  max-width: var(--max-width);
  margin: 0 auto;
  padding: 0 var(--content-padding) 100px;
  display: grid;
  grid-template-columns: 220px 1fr;
  gap: 80px;
}

/* ----------------------------------------
   Sidebar
   ---------------------------------------- */
.docs-sidebar {
  position: sticky;
  top: 100px;
  height: fit-content;
  padding-right: 24px;
  border-right: 1px solid var(--border);
}

.docs-sidebar__title {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--text-muted);
  text-transform: uppercase;
  letter-spacing: 0.1em;
  margin-bottom: 16px;
}

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

.docs-sidebar__nav li {
  margin-bottom: 0;
}

.docs-sidebar__link {
  display: block;
  padding: 8px 0;
  font-size: var(--text-sm);
  color: var(--text-muted);
  text-decoration: none;
  transition: color 0.15s ease;
  border-left: 2px solid transparent;
  padding-left: 12px;
  margin-left: -14px;
}

.docs-sidebar__link:hover,
.docs-sidebar__link.is-active {
  color: var(--text);
  border-left-color: var(--amber);
}

/* ----------------------------------------
   Docs Content
   ---------------------------------------- */
.docs-content {
  min-width: 0; /* Prevents overflow on small screens */
}

.docs-section {
  margin-bottom: 64px;
  padding-bottom: 64px;
  border-bottom: 1px solid var(--border);
}

.docs-section:last-child {
  border-bottom: none;
  margin-bottom: 0;
  padding-bottom: 0;
}

.docs-section__title {
  font-size: var(--text-3xl);
  font-weight: 700;
  letter-spacing: -0.02em;
  margin-bottom: 24px;
}

.docs-section h4 {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-md);
  font-weight: 600;
  margin-top: 32px;
  margin-bottom: 12px;
  color: var(--text);
}

.docs-section h5 {
  font-size: var(--text-md);
  font-weight: 600;
  margin-bottom: 8px;
}

.docs-section p {
  color: var(--text-muted);
  line-height: 1.7;
}

.docs-section ul,
.docs-section ol {
  color: var(--text-muted);
  margin-bottom: 1.5rem;
}

.docs-section li {
  margin-bottom: 8px;
  line-height: 1.6;
}

/* ----------------------------------------
   Docs Table
   ---------------------------------------- */
.docs-table {
  width: 100%;
  border: 1px solid var(--border);
  border-collapse: collapse;
  font-size: var(--text-md);
  margin-bottom: 1.5rem;
}

.docs-table th {
  background: var(--bg-raised);
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-muted);
  text-align: left;
  padding: 12px 16px;
  border-bottom: 1px solid var(--border);
}

.docs-table td {
  padding: 12px 16px;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
  color: var(--text-muted);
}

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

.docs-table code {
  font-size: var(--text-sm);
}

/* ----------------------------------------
   Step List
   ---------------------------------------- */
.step-list {
  counter-reset: step;
  list-style: none;
  padding-left: 0;
}

.step-list li {
  position: relative;
  padding-left: 40px;
  margin-bottom: 16px;
}

.step-list li::before {
  counter-increment: step;
  content: counter(step);
  position: absolute;
  left: 0;
  top: 0;
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  font-weight: 600;
  width: 24px;
  height: 24px;
  background: var(--bg-raised);
  border: 1px solid var(--border);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--amber);
}

/* ----------------------------------------
   Attribute List
   ---------------------------------------- */
.attribute-list {
  list-style: none;
  padding: 0;
  margin: 0 0 1.5rem;
}

.attribute-list__item {
  display: flex;
  gap: 16px;
  align-items: flex-start;
  padding: 16px 0;
  border-bottom: 1px solid var(--border);
}

.attribute-list__item:last-child {
  border-bottom: none;
}

.attribute-list__number {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  font-weight: 600;
  width: 28px;
  height: 28px;
  background: var(--bg-raised);
  border: 1px solid var(--border);
  display: flex;
  align-items: center;
  justify-content: center;
  color: var(--amber);
  flex-shrink: 0;
}

.attribute-list__content h5 {
  font-size: var(--text-md);
  font-weight: 600;
  margin-bottom: 4px;
  color: var(--text);
}

.attribute-list__content p {
  margin: 0;
  color: var(--text-muted);
  font-size: var(--text-md);
}

/* ----------------------------------------
   Feature List (Check marks)
   ---------------------------------------- */
.feature-list {
  list-style: none;
  padding: 0;
}

.feature-list li {
  position: relative;
  padding-left: 28px;
  margin-bottom: 12px;
}

.feature-list li::before {
  content: '\2713';
  position: absolute;
  left: 0;
  color: var(--success);
  font-weight: 600;
}

/* ----------------------------------------
   Use Case Grid
   ---------------------------------------- */
.use-case-grid {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: 24px;
  margin-bottom: 1.5rem;
}

.use-case-list {
  background: var(--bg-raised);
  border: 1px solid var(--border);
  padding: 24px;
}

.use-case-list__title {
  font-family: 'JetBrains Mono', monospace;
  font-size: var(--text-sm);
  font-weight: 600;
  margin-bottom: 16px;
  display: flex;
  align-items: center;
  gap: 8px;
}

.use-case-list--good .use-case-list__title {
  color: var(--success);
}

.use-case-list--bad .use-case-list__title {
  color: var(--error);
}

.use-case-list ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

.use-case-list li {
  padding-left: 0;
  margin-bottom: 8px;
  color: var(--text-muted);
  font-size: var(--text-md);
}

/* ----------------------------------------
   Responsive Docs
   ---------------------------------------- */
@media (max-width: 1000px) {
  .docs-layout {
    grid-template-columns: 1fr;
    gap: 40px;
  }

  .docs-sidebar {
    position: static;
    border-right: none;
    border-bottom: 1px solid var(--border);
    padding-right: 0;
    padding-bottom: 24px;
  }

  .docs-sidebar__nav {
    display: flex;
    flex-wrap: wrap;
    gap: 8px;
  }

  .docs-sidebar__link {
    border-left: none;
    padding-left: 0;
    margin-left: 0;
    padding: 8px 12px;
    background: var(--bg-raised);
    border: 1px solid var(--border);
  }

  .docs-sidebar__link:hover,
  .docs-sidebar__link.is-active {
    border-color: var(--amber);
  }

  .page-header {
    padding: 60px var(--content-padding) 40px;
  }

  .use-case-grid {
    grid-template-columns: 1fr;
  }
}