/* API Reference Styles - Extension of main site styles
   Inherits from ../../style.css and adds API-specific components */

/* =====================
   API-SPECIFIC VARIABLES
   ===================== */
:root {
  /* Inherits all variables from main style.css */
  /* Additional API-specific variables */
  --api-sidebar-width: 260px;
  --api-toc-width: 240px;
  --api-grid-gap: 2rem;
  --api-module-border: 3px;
}

/* =====================
   API HERO SECTION
   ===================== */
.api-hero {
  padding: 3rem 1rem 2.5rem;
}

.api-version-info {
  margin-top: 1rem;
  display: flex;
  gap: 0.5rem;
  justify-content: center;
}

.api-version-badge {
  display: inline-block;
  padding: 0.25rem 0.75rem;
  background-color: rgba(255, 255, 255, 0.2);
  color: white;
  border-radius: var(--radius-sm);
  font-size: 0.85rem;
  font-weight: 600;
}

.api-version-badge.stable {
  background-color: var(--clr-success);
}

/* =====================
   API CONTAINER
   ===================== */
.api-container {
  padding: 2rem 0;
}

/* =====================
   BREADCRUMBS
   ===================== */
.api-breadcrumbs {
  padding: 1rem 0;
  font-size: 0.9rem;
  color: var(--clr-grey-500);
}

.api-breadcrumbs a {
  color: var(--clr-primary-600);
  text-decoration: none;
}

.api-breadcrumbs a:hover {
  color: var(--clr-primary-400);
  text-decoration: underline;
}

.api-breadcrumbs .separator {
  margin: 0 0.5rem;
  color: var(--clr-grey-300);
}

/* =====================
   SEARCH BOX
   ===================== */
.api-search-container {
  position: relative;
  margin-bottom: 2rem;
}

.api-search-input {
  width: 100%;
  padding: 0.75rem 1rem 0.75rem 3rem;
  font-size: 1rem;
  font-family: var(--font-sans);
  border: 2px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  background-color: var(--clr-surface);
  transition: border-color var(--ease-fast), box-shadow var(--ease-fast);
}

.api-search-input:focus {
  outline: none;
  border-color: var(--clr-primary-400);
  box-shadow: 0 0 0 3px rgba(26, 163, 255, 0.1);
}

.api-search-icon {
  position: absolute;
  left: 1rem;
  top: 50%;
  transform: translateY(-50%);
  color: var(--clr-grey-500);
}

.api-search-results {
  position: absolute;
  top: 100%;
  left: 0;
  right: 0;
  margin-top: 0.5rem;
  background: var(--clr-surface);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  box-shadow: var(--shadow-md);
  max-height: 400px;
  overflow-y: auto;
  display: none;
  z-index: 100;
}

.search-result-item {
  display: block;
  padding: 0.75rem 1rem;
  border-bottom: 1px solid var(--clr-grey-100);
  color: var(--clr-grey-700);
  text-decoration: none;
  transition: background-color var(--ease-fast);
}

.search-result-item:hover {
  background-color: var(--clr-grey-100);
}

.result-name {
  font-weight: 600;
  color: var(--clr-primary-600);
}

.result-module {
  font-size: 0.85rem;
  color: var(--clr-grey-500);
}

/* =====================
   QUICK NAVIGATION CARDS
   ===================== */
.api-quick-nav {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: 1.5rem;
  margin-bottom: 3rem;
}

.api-nav-card {
  background: var(--clr-surface);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  padding: 1.5rem;
  text-align: center;
  transition: transform var(--ease-fast), box-shadow var(--ease-fast);
}

.api-nav-card:hover {
  transform: translateY(-2px);
  box-shadow: var(--shadow-md);
}

.api-nav-card i {
  font-size: 2rem;
  color: var(--clr-primary-400);
  margin-bottom: 0.75rem;
}

.api-nav-card h3 {
  margin: 0.5rem 0;
  color: var(--clr-primary-700);
}

.api-nav-card p {
  margin: 0.5rem 0;
  font-size: 0.9rem;
  color: var(--clr-grey-500);
}

.api-nav-card a {
  color: var(--clr-primary-600);
  font-weight: 600;
  text-decoration: none;
}

/* =====================
   API SECTIONS
   ===================== */
.api-section {
  margin-bottom: 3rem;
}

.api-section h2 {
  color: var(--clr-primary-700);
  border-bottom: 2px solid var(--clr-primary-400);
  padding-bottom: 0.5rem;
  margin-bottom: 1.5rem;
}

/* =====================
   MODULE GRID LAYOUT
   ===================== */
.api-grid {
  display: grid;
  grid-template-columns: var(--api-sidebar-width) minmax(0, 1fr) var(--api-toc-width);
  gap: var(--api-grid-gap);
  margin-top: 2rem;
}

/* =====================
   SIDEBAR NAVIGATION
   ===================== */
.api-sidebar {
  position: sticky;
  top: 5rem;
  align-self: start;
}

.sidebar-section {
  background: var(--clr-surface);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  padding: 1rem;
  box-shadow: var(--shadow-sm);
}

.sidebar-title {
  margin: 0 0 0.75rem;
  font-size: 0.85rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--clr-grey-500);
  font-weight: 600;
}

.api-sidebar-nav ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

.api-sidebar-nav li {
  margin-bottom: 0.25rem;
}

.api-sidebar-nav a {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.5rem 0.75rem;
  color: var(--clr-grey-700);
  text-decoration: none;
  border-radius: var(--radius-sm);
  font-size: 0.9rem;
  transition: background-color var(--ease-fast), color var(--ease-fast);
}

.api-sidebar-nav a:hover {
  background-color: var(--clr-grey-100);
  color: var(--clr-primary-600);
}

.api-sidebar-nav a.active {
  background-color: var(--clr-primary-600);
  color: white;
}

.api-sidebar-nav i {
  font-size: 0.85rem;
  opacity: 0.7;
}

/* =====================
   API MODULES
   ===================== */
.api-module {
  background: var(--clr-surface);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  padding: 1.5rem;
  margin-bottom: 2rem;
  box-shadow: var(--shadow-sm);
}

.api-module-header {
  display: flex;
  align-items: baseline;
  gap: 1rem;
  margin-bottom: 1rem;
  padding-bottom: 0.75rem;
  border-bottom: var(--api-module-border) solid var(--clr-primary-400);
}

.api-module-header h3 {
  margin: 0;
  font-family: Consolas, monospace;
  font-size: 1.5rem;
  color: var(--clr-primary-700);
}

.api-module-badge {
  display: inline-block;
  padding: 0.2rem 0.6rem;
  background-color: var(--clr-primary-400);
  color: white;
  border-radius: var(--radius-sm);
  font-size: 0.75rem;
  font-weight: 600;
  text-transform: uppercase;
}

.api-module-description {
  color: var(--clr-grey-700);
  margin: 1rem 0;
  line-height: 1.6;
}

/* =====================
   API TABLES
   ===================== */
.api-table {
  width: 100%;
  border-collapse: collapse;
  margin: 1rem 0;
  font-size: 0.9rem;
  table-layout: fixed;
  word-wrap: break-word;
}

.api-table th {
  background-color: var(--clr-grey-100);
  color: var(--clr-primary-700);
  padding: 0.75rem;
  text-align: left;
  font-weight: 600;
  border: 1px solid var(--clr-grey-300);
}

.api-table td {
  padding: 0.75rem;
  border: 1px solid var(--clr-grey-300);
  vertical-align: top;
  overflow-wrap: break-word;
}

.api-table tbody tr:nth-child(even) {
  background-color: rgba(0, 0, 0, 0.02);
}

.api-table tbody tr:hover {
  background-color: var(--clr-grey-100);
}

.api-table code {
  background-color: rgba(26, 163, 255, 0.1);
  padding: 0.15rem 0.3rem;
  border-radius: 3px;
  font-size: 0.85rem;
  word-break: break-word;
}

/* Responsive table wrapper */
.api-table-responsive {
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
}

@media (max-width: 768px) {
  .api-table {
    table-layout: auto;
  }

  .api-submodules,
  .api-parameters {
    overflow-x: auto;
  }

  .api-table {
    min-width: 500px;
  }
}

/* =====================
   API EXAMPLES
   ===================== */
.api-example {
  margin: 1.5rem 0;
}

.api-example h4 {
  color: var(--clr-primary-700);
  margin-bottom: 0.75rem;
}

.api-example pre {
  background-color: var(--clr-grey-100);
  border: 1px solid var(--clr-grey-300);
  border-left: 4px solid var(--clr-primary-400);
}

.api-example-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: 1.5rem;
  margin-top: 1.5rem;
}

.api-example-card {
  background: var(--clr-surface);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  padding: 1.25rem;
}

.api-example-card h3 {
  margin-top: 0;
  color: var(--clr-primary-700);
  font-size: 1.1rem;
}

/* =====================
   SIMULATION CARDS
   ===================== */
.api-cards {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: 1.5rem;
  margin: 1.5rem 0;
}

.api-card {
  background: var(--clr-grey-100);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  padding: 1.25rem;
}

.api-card h5 {
  margin-top: 0;
  color: var(--clr-primary-700);
}

.api-card ul {
  margin: 0.5rem 0;
  padding-left: 1.5rem;
}

.api-card li {
  margin: 0.25rem 0;
  font-size: 0.9rem;
}

/* =====================
   RIGHT TOC SIDEBAR
   ===================== */
.api-toc-sidebar {
  position: sticky;
  top: 5rem;
  align-self: start;
}

.api-local-toc {
  max-height: calc(100vh - 7rem);
  overflow-y: auto;
}

.api-local-toc ol {
  list-style: none;
  padding: 0;
  margin: 0;
}

.api-local-toc li {
  margin: 0.5rem 0;
}

.api-local-toc a {
  color: var(--clr-grey-700);
  text-decoration: none;
  font-size: 0.85rem;
  display: block;
  padding: 0.25rem 0.5rem;
  border-left: 2px solid transparent;
  transition: all var(--ease-fast);
}

.api-local-toc a:hover {
  color: var(--clr-primary-600);
  border-left-color: var(--clr-primary-400);
  background-color: var(--clr-grey-100);
}

.api-local-toc a.active {
  color: var(--clr-primary-600);
  border-left-color: var(--clr-primary-600);
  background-color: rgba(26, 163, 255, 0.1);
  font-weight: 600;
}

/* =====================
   CONVENTIONS SECTION
   ===================== */
.api-conventions-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
  gap: 2rem;
  margin-top: 1.5rem;
}

.convention-block {
  background: var(--clr-surface);
  border: 1px solid var(--clr-grey-300);
  border-radius: var(--radius-md);
  padding: 1.25rem;
}

.convention-block h3 {
  margin-top: 0;
  color: var(--clr-primary-700);
  font-size: 1.1rem;
}

.convention-block ul {
  margin: 0.75rem 0;
  padding-left: 1.5rem;
}

.convention-block li {
  margin: 0.5rem 0;
  line-height: 1.5;
}

.convention-block strong {
  color: var(--clr-primary-700);
}

/* =====================
   ADMONITIONS (scipy-style)
   ===================== */
.admonition {
  border-left: 4px solid var(--clr-grey-300);
  background: var(--clr-grey-100);
  padding: 0.75rem 1rem;
  margin: 1.25rem 0;
  border-radius: var(--radius-sm);
}

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

.admonition.note {
  border-left-color: var(--clr-warning);
  background: rgba(255, 182, 39, 0.12);
}

.admonition.info {
  border-left-color: var(--clr-primary-400);
  background: rgba(26, 163, 255, 0.12);
}

.admonition.warning {
  border-left-color: var(--clr-danger);
  background: rgba(255, 107, 107, 0.12);
}

/* =====================
   RESPONSIVE DESIGN
   ===================== */
@media (max-width: 1200px) {
  .api-grid {
    grid-template-columns: var(--api-sidebar-width) minmax(0, 1fr);
  }

  .api-toc-sidebar {
    display: none;
  }
}

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

  .api-sidebar {
    position: static;
    margin-bottom: 2rem;
  }

  .api-toc-sidebar {
    display: none;
  }

  .api-quick-nav {
    grid-template-columns: 1fr;
  }

  .api-example-grid,
  .api-cards,
  .api-conventions-grid {
    grid-template-columns: 1fr;
  }
}

@media (max-width: 600px) {
  .api-module-header {
    flex-direction: column;
    align-items: flex-start;
  }

  .api-table {
    font-size: 0.85rem;
  }

  .api-table th,
  .api-table td {
    padding: 0.5rem;
  }

  /* Ensure main content takes full width */
  .api-main-content {
    width: 100%;
    min-width: 0;
  }

  /* Make tables scrollable on mobile */
  .api-table-wrapper,
  .api-submodules {
    overflow-x: auto;
  }

  .api-table {
    min-width: 500px;
  }
}

/* Ensure smooth transitions */
.api-grid,
.api-sidebar,
.api-main-content,
.api-toc-sidebar {
  transition: all 0.3s ease;
}

/* Prevent content overflow */
.api-main-content {
  min-width: 0;
  overflow-wrap: break-word;
}

/* Fix for sticky sidebars on resize */
@media (min-width: 901px) {
  .api-sidebar {
    position: sticky;
    top: 5rem;
    align-self: start;
    max-height: calc(100vh - 6rem);
    overflow-y: auto;
  }
}

@media (min-width: 1201px) {
  .api-toc-sidebar {
    display: block;
    position: sticky;
    top: 5rem;
    align-self: start;
    max-height: calc(100vh - 6rem);
    overflow-y: auto;
  }
}

/* =====================
   UTILITY CLASSES
   ===================== */
.api-loading {
  display: flex;
  justify-content: center;
  align-items: center;
  min-height: 200px;
  color: var(--clr-grey-500);
}

.api-loading::after {
  content: "";
  width: 40px;
  height: 40px;
  border: 4px solid var(--clr-grey-300);
  border-top-color: var(--clr-primary-400);
  border-radius: 50%;
  animation: spin 1s linear infinite;
}

@keyframes spin {
  to {
    transform: rotate(360deg);
  }
}

.api-error {
  background-color: var(--clr-danger);
  color: white;
  padding: 1rem;
  border-radius: var(--radius-md);
  margin: 1rem 0;
  text-align: center;
}

/* Class list styling */
.api-classes {
  margin-top: 1.5rem;
}

.api-classes h4 {
  color: var(--clr-primary-700);
  margin-bottom: 0.75rem;
}

.api-class-list {
  list-style: none;
  padding: 0;
  margin: 0;
}

.api-class-list li {
  padding: 0.5rem 0;
  border-bottom: 1px solid var(--clr-grey-300);
}

.api-class-list li:last-child {
  border-bottom: none;
}

.api-class-list a {
  color: var(--clr-primary-600);
  text-decoration: none;
  font-weight: 500;
}

.api-class-list a:hover {
  color: var(--clr-primary-400);
  text-decoration: underline;
}

/* Documentation link button */
.api-documentation-link {
  margin-top: 1.5rem;
  text-align: center;
}

.api-doc-button {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.75rem 1.5rem;
  background-color: var(--clr-primary-600);
  color: white;
  text-decoration: none;
  border-radius: var(--radius-md);
  font-weight: 600;
  transition: all var(--ease-fast);
}

.api-doc-button:hover {
  background-color: var(--clr-primary-400);
  transform: translateY(-2px);
  box-shadow: var(--shadow-md);
}

.api-doc-button i {
  font-size: 1rem;
}

/* Monospace inline code styling */
code {
  font-family: Consolas, 'Courier New', monospace;
}

/* Ensure proper spacing for nested lists */
.api-submodules ul {
  margin-top: 0.5rem;
  padding-left: 1.5rem;
}

.api-submodules li {
  margin: 0.25rem 0;
}

/* Mobile sidebar toggle button */
.api-sidebar-toggle {
  display: none;
  position: fixed;
  bottom: 2rem;
  right: 2rem;
  z-index: 999;
  padding: 0.75rem 1rem;
  background-color: var(--clr-primary-600);
  color: white;
  border: none;
  border-radius: var(--radius-pill);
  box-shadow: var(--shadow-md);
  cursor: pointer;
  font-weight: 600;
  transition: all var(--ease-fast);
}

.api-sidebar-toggle:hover {
  background-color: var(--clr-primary-400);
  transform: scale(1.05);
}

@media (max-width: 900px) {
  .api-sidebar-toggle {
    display: flex;
    align-items: center;
    gap: 0.5rem;
  }
}

/* Prevent horizontal scroll */
.api-container {
  overflow-x: hidden;
}

/* Fix pre code blocks overflow */
pre {
  max-width: 100%;
  overflow-x: auto;
}

/* Ensure images don't break layout */
img {
  max-width: 100%;
  height: auto;
}