/* ==========================================================================
   FlowAboard Documentation Stylesheet - Premium Developer Theme
   ========================================================================== */

/* Color Schemes & Variables */
:root[data-theme="dark"] {
  --bg-primary: #0b0f19;
  --bg-secondary: #111827;
  --bg-tertiary: #1f2937;
  --header-bg-rgb: 11, 15, 25;
  --text-primary: #f3f4f6;
  --text-secondary: #9ca3af;
  --text-muted: #6b7280;
  --accent-color: #6366f1;
  --accent-hover: #818cf8;
  --accent-rgb: 99, 102, 241;
  --border-color: rgba(255, 255, 255, 0.07);
  --border-hover: rgba(255, 255, 255, 0.15);
  --sidebar-active-bg: rgba(99, 102, 241, 0.12);
  --sidebar-active-text: #818cf8;
  --code-bg: #0f172a;
  --code-token-comment: #64748b;
  --kbd-bg: #374151;
  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.3);
  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.4);
  --scrollbar-thumb: #374151;
  --scrollbar-track: #111827;
  --toc-active: #818cf8;
  
  /* Alerts */
  --alert-note-bg: rgba(59, 130, 246, 0.08);
  --alert-note-border: rgba(59, 130, 246, 0.3);
  --alert-note-text: #60a5fa;
  --alert-warning-bg: rgba(245, 158, 11, 0.08);
  --alert-warning-border: rgba(245, 158, 11, 0.3);
  --alert-warning-text: #fbbf24;
  --alert-important-bg: rgba(139, 92, 246, 0.08);
  --alert-important-border: rgba(139, 92, 246, 0.3);
  --alert-important-text: #a78bfa;
  --alert-caution-bg: rgba(239, 68, 68, 0.08);
  --alert-caution-border: rgba(239, 68, 68, 0.3);
  --alert-caution-text: #f87171;
  --alert-tip-bg: rgba(16, 185, 129, 0.08);
  --alert-tip-border: rgba(16, 185, 129, 0.3);
  --alert-tip-text: #34d399;
}

:root[data-theme="light"] {
  --bg-primary: #ffffff;
  --bg-secondary: #f9fafb;
  --bg-tertiary: #f3f4f6;
  --header-bg-rgb: 255, 255, 255;
  --text-primary: #111827;
  --text-secondary: #4b5563;
  --text-muted: #9ca3af;
  --accent-color: #4f46e5;
  --accent-hover: #4338ca;
  --accent-rgb: 79, 70, 229;
  --border-color: rgba(0, 0, 0, 0.08);
  --border-hover: rgba(0, 0, 0, 0.15);
  --sidebar-active-bg: rgba(79, 70, 229, 0.06);
  --sidebar-active-text: #4f46e5;
  --code-bg: #f8fafc;
  --code-token-comment: #94a3b8;
  --kbd-bg: #e5e7eb;
  --shadow-sm: 0 1px 2px 0 rgba(0, 0, 0, 0.05);
  --shadow-md: 0 4px 6px -1px rgba(0, 0, 0, 0.05);
  --scrollbar-thumb: #d1d5db;
  --scrollbar-track: #f9fafb;
  --toc-active: #4f46e5;

  /* Alerts */
  --alert-note-bg: rgba(59, 130, 246, 0.05);
  --alert-note-border: rgba(59, 130, 246, 0.2);
  --alert-note-text: #1d4ed8;
  --alert-warning-bg: rgba(245, 158, 11, 0.05);
  --alert-warning-border: rgba(245, 158, 11, 0.2);
  --alert-warning-text: #b45309;
  --alert-important-bg: rgba(139, 92, 246, 0.05);
  --alert-important-border: rgba(139, 92, 246, 0.2);
  --alert-important-text: #6d28d9;
  --alert-caution-bg: rgba(239, 68, 68, 0.05);
  --alert-caution-border: rgba(239, 68, 68, 0.2);
  --alert-caution-text: #b91c1c;
  --alert-tip-bg: rgba(16, 185, 129, 0.05);
  --alert-tip-border: rgba(16, 185, 129, 0.2);
  --alert-tip-text: #047857;
}

/* Core Resets & Base Styles */
* {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  font-family: 'Inter', sans-serif;
  color: var(--text-primary);
  background-color: var(--bg-primary);
  scroll-behavior: smooth;
}

body {
  min-height: 100vh;
  display: flex;
  flex-direction: column;
}

/* Scrollbar Customization */
::-webkit-scrollbar {
  width: 8px;
  height: 8px;
}
::-webkit-scrollbar-track {
  background: var(--scrollbar-track);
}
::-webkit-scrollbar-thumb {
  background: var(--scrollbar-thumb);
  border-radius: 4px;
}
::-webkit-scrollbar-thumb:hover {
  background: var(--text-muted);
}

/* Glassmorphic Header Navigation */
.docs-header {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 64px;
  background-color: rgba(var(--header-bg-rgb), 0.85);
  backdrop-filter: blur(12px);
  -webkit-backdrop-filter: blur(12px);
  border-bottom: 1px solid var(--border-color);
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 24px;
  z-index: 1000;
}

.header-left, .header-right {
  display: flex;
  align-items: center;
  gap: 16px;
}

.docs-logo {
  display: flex;
  align-items: center;
  gap: 10px;
  text-decoration: none;
  font-family: 'Outfit', sans-serif;
  font-size: 1.15rem;
  font-weight: 700;
  color: var(--text-primary);
}

.docs-logo img {
  height: 28px;
  width: 28px;
}

.logo-badge {
  font-size: 0.7rem;
  padding: 2px 6px;
  border-radius: 4px;
  background-color: rgba(var(--accent-rgb), 0.15);
  color: var(--accent-hover);
  border: 1px solid rgba(var(--accent-rgb), 0.2);
  margin-left: 2px;
}

/* Search Trigger Bar */
.search-trigger {
  display: flex;
  align-items: center;
  gap: 10px;
  background-color: var(--bg-secondary);
  border: 1px solid var(--border-color);
  border-radius: 6px;
  padding: 6px 12px;
  min-width: 260px;
  max-width: 480px;
  width: 32vw;
  cursor: pointer;
  color: var(--text-secondary);
  font-size: 0.85rem;
  transition: border-color 0.2s, background-color 0.2s;
}

.search-trigger:hover {
  border-color: var(--border-hover);
  background-color: var(--bg-tertiary);
}

.search-trigger kbd {
  margin-left: auto;
  font-size: 0.7rem;
  background-color: var(--kbd-bg);
  color: var(--text-secondary);
  padding: 2px 6px;
  border-radius: 4px;
  border: 1px solid var(--border-color);
}

.nav-links {
  display: flex;
  gap: 20px;
}

.nav-links a {
  font-size: 0.9rem;
  color: var(--text-secondary);
  text-decoration: none;
  font-weight: 500;
  transition: color 0.2s;
}

.nav-links a:hover {
  color: var(--text-primary);
}

.theme-toggle-btn {
  background: none;
  border: none;
  cursor: pointer;
  color: var(--text-secondary);
  font-size: 1rem;
  padding: 8px;
  border-radius: 6px;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: background-color 0.2s, color 0.2s;
}

.theme-toggle-btn:hover {
  background-color: var(--bg-secondary);
  color: var(--text-primary);
}

/* 3-Column Docs Layout */
.docs-container {
  display: flex;
  flex: 1;
  padding-top: 64px;
  max-width: 1440px;
  margin: 0 auto;
  width: 100%;
}

/* Left Sidebar Navigation */
.docs-sidebar {
  width: 280px;
  position: fixed;
  top: 64px;
  bottom: 0;
  left: max(0px, calc((100vw - 1440px) / 2));
  background-color: var(--bg-primary);
  border-right: 1px solid var(--border-color);
  padding: 24px;
  overflow-y: auto;
  z-index: 100;
}

.sidebar-group {
  margin-bottom: 24px;
}

.sidebar-group-title {
  font-family: 'Outfit', sans-serif;
  font-size: 0.75rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-muted);
  font-weight: 700;
  margin-bottom: 10px;
  padding-left: 8px;
}

.sidebar-menu {
  list-style: none;
}

.sidebar-link {
  display: block;
  font-size: 0.88rem;
  color: var(--text-secondary);
  text-decoration: none;
  padding: 8px 12px;
  border-radius: 6px;
  transition: all 0.2s;
  cursor: pointer;
  border-left: 2px solid transparent;
}

.sidebar-link:hover {
  color: var(--text-primary);
  background-color: var(--bg-secondary);
}

.sidebar-link.active {
  color: var(--sidebar-active-text);
  background-color: var(--sidebar-active-bg);
  border-left-color: var(--accent-color);
  font-weight: 500;
}

.sidebar-loader {
  display: flex;
  align-items: center;
  gap: 10px;
  color: var(--text-muted);
  font-size: 0.85rem;
  padding: 10px;
}

/* Center Content Area */
.docs-content-wrapper {
  flex: 1;
  margin-left: 280px;
  margin-right: 280px;
  padding: 32px 48px;
  min-width: 0; /* Prevents flex items from overflowing */
}

.docs-breadcrumbs {
  display: flex;
  align-items: center;
  gap: 8px;
  font-size: 0.8rem;
  color: var(--text-muted);
  margin-bottom: 24px;
}

.docs-breadcrumbs .separator {
  font-size: 0.65rem;
}

.docs-breadcrumbs .breadcrumb-item.active {
  color: var(--text-secondary);
}

.content-loader {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  padding: 100px 0;
  color: var(--text-muted);
  font-size: 1.1rem;
  gap: 15px;
}

/* Article Styling (Rendered Markdown) */
.docs-article {
  line-height: 1.7;
  color: var(--text-secondary);
}

.docs-article h1,
.docs-article h2,
.docs-article h3,
.docs-article h4 {
  font-family: 'Outfit', sans-serif;
  color: var(--text-primary);
  font-weight: 700;
  margin-top: 2rem;
  margin-bottom: 1rem;
  scroll-margin-top: 80px; /* Offset for header during anchor click scroll */
}

.docs-article h1 {
  font-size: 2.2rem;
  margin-top: 0;
  border-bottom: 1px solid var(--border-color);
  padding-bottom: 12px;
}

.docs-article h2 {
  font-size: 1.5rem;
  border-bottom: 1px solid var(--border-color);
  padding-bottom: 8px;
}

.docs-article h3 {
  font-size: 1.2rem;
}

.docs-article p {
  margin-bottom: 1.25rem;
  font-size: 0.96rem;
}

.docs-article strong {
  color: var(--text-primary);
}

.docs-article a {
  color: var(--accent-color);
  text-decoration: none;
  font-weight: 500;
  border-bottom: 1px solid transparent;
  transition: border-color 0.2s, color 0.2s;
}

.docs-article a:hover {
  color: var(--accent-hover);
  border-bottom-color: var(--accent-hover);
}

.docs-article ul,
.docs-article ol {
  margin-bottom: 1.25rem;
  padding-left: 24px;
}

.docs-article li {
  margin-bottom: 0.5rem;
  font-size: 0.96rem;
}

/* Divider line */
.docs-article hr {
  height: 1px;
  border: none;
  background-color: var(--border-color);
  margin: 2.5rem 0;
}

/* Tables style */
.docs-article table {
  width: 100%;
  border-collapse: collapse;
  margin-bottom: 1.5rem;
  font-size: 0.9rem;
  border: 1px solid var(--border-color);
}

.docs-article th {
  background-color: var(--bg-secondary);
  color: var(--text-primary);
  font-weight: 600;
  text-align: left;
  border-bottom: 2px solid var(--border-color);
  padding: 10px 14px;
}

.docs-article td {
  padding: 10px 14px;
  border-bottom: 1px solid var(--border-color);
}

.docs-article tr:hover td {
  background-color: var(--bg-secondary);
}

/* Inline Code Code blocks styles */
.docs-article :not(pre) > code {
  font-family: 'Fira Code', monospace;
  font-size: 0.85rem;
  background-color: var(--code-bg);
  color: var(--accent-hover);
  padding: 2px 6px;
  border-radius: 4px;
  border: 1px solid var(--border-color);
}

/* Pre block formatting with relative wrapper */
.code-block-wrapper {
  position: relative;
  margin-bottom: 1.5rem;
  border-radius: 8px;
  overflow: hidden;
  border: 1px solid var(--border-color);
  box-shadow: var(--shadow-sm);
}

.code-block-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 8px 16px;
  background-color: var(--bg-secondary);
  border-bottom: 1px solid var(--border-color);
  font-size: 0.75rem;
  color: var(--text-muted);
  text-transform: uppercase;
}

.code-block-lang {
  font-weight: 600;
}

.copy-btn {
  background: none;
  border: 1px solid var(--border-color);
  color: var(--text-secondary);
  padding: 4px 8px;
  border-radius: 4px;
  cursor: pointer;
  display: flex;
  align-items: center;
  gap: 5px;
  font-size: 0.75rem;
  transition: all 0.2s;
}

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

/* Custom Pre Styles */
.docs-article pre {
  margin: 0;
  padding: 16px;
  overflow-x: auto;
  background-color: var(--code-bg) !important;
  font-size: 0.88rem;
  line-height: 1.5;
}

.docs-article pre code {
  font-family: 'Fira Code', monospace;
  background: none;
  border: none;
  padding: 0;
  border-radius: 0;
  color: inherit;
}

/* Prism Overrides for Theme Harmony */
.token.comment, .token.prolog, .token.doctype, .token.cdata {
  color: var(--code-token-comment) !important;
}

/* Mermaid Wrapper */
.mermaid-wrapper {
  display: flex;
  justify-content: center;
  background-color: var(--code-bg);
  border: 1px solid var(--border-color);
  border-radius: 8px;
  padding: 24px;
  margin-bottom: 1.5rem;
  overflow-x: auto;
}

/* GitHub style Callout / Alert elements */
.alert {
  padding: 14px 18px;
  border-left: 4px solid transparent;
  border-radius: 0 6px 6px 0;
  margin-bottom: 1.5rem;
}

.alert-title {
  display: flex;
  align-items: center;
  gap: 8px;
  font-weight: 600;
  font-size: 0.88rem;
  margin-bottom: 6px;
  text-transform: uppercase;
}

.alert p {
  margin-bottom: 0;
  font-size: 0.92rem;
}

.alert-note {
  background-color: var(--alert-note-bg);
  border-left-color: var(--alert-note-border);
  color: var(--text-secondary);
}
.alert-note .alert-title {
  color: var(--alert-note-text);
}

.alert-warning {
  background-color: var(--alert-warning-bg);
  border-left-color: var(--alert-warning-border);
  color: var(--text-secondary);
}
.alert-warning .alert-title {
  color: var(--alert-warning-text);
}

.alert-important {
  background-color: var(--alert-important-bg);
  border-left-color: var(--alert-important-border);
  color: var(--text-secondary);
}
.alert-important .alert-title {
  color: var(--alert-important-text);
}

.alert-caution {
  background-color: var(--alert-caution-bg);
  border-left-color: var(--alert-caution-border);
  color: var(--text-secondary);
}
.alert-caution .alert-title {
  color: var(--alert-caution-text);
}

.alert-tip {
  background-color: var(--alert-tip-bg);
  border-left-color: var(--alert-tip-border);
  color: var(--text-secondary);
}
.alert-tip .alert-title {
  color: var(--alert-tip-text);
}

/* Next / Prev Nav Footer */
.page-nav-footer {
  display: flex;
  justify-content: space-between;
  border-top: 1px solid var(--border-color);
  padding-top: 24px;
  margin-top: 48px;
}

.page-nav-card {
  display: flex;
  flex-direction: column;
  gap: 4px;
  max-width: 48%;
  text-decoration: none;
  padding: 12px 16px;
  border-radius: 8px;
  border: 1px solid var(--border-color);
  background-color: var(--bg-primary);
  min-width: 140px;
  transition: all 0.2s;
}

.page-nav-card:hover {
  border-color: var(--accent-color);
  background-color: var(--bg-secondary);
  transform: translateY(-2px);
}

.page-nav-card.next {
  text-align: right;
  margin-left: auto;
}

.page-nav-label {
  font-size: 0.72rem;
  color: var(--text-muted);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

.page-nav-title {
  font-family: 'Outfit', sans-serif;
  font-size: 0.95rem;
  font-weight: 600;
  color: var(--text-primary);
}

/* Right Sidebar Table of Contents */
.docs-toc {
  width: 280px;
  position: fixed;
  top: 64px;
  bottom: 0;
  right: max(0px, calc((100vw - 1440px) / 2));
  background-color: var(--bg-primary);
  border-left: 1px solid var(--border-color);
  padding: 24px;
  overflow-y: auto;
  z-index: 100;
}

.toc-sticky {
  position: sticky;
  top: 0;
}

.toc-title {
  font-family: 'Outfit', sans-serif;
  font-size: 0.78rem;
  text-transform: uppercase;
  color: var(--text-primary);
  font-weight: 700;
  margin-bottom: 12px;
}

.toc-links {
  display: flex;
  flex-direction: column;
  gap: 8px;
}

.toc-link {
  font-size: 0.82rem;
  color: var(--text-secondary);
  text-decoration: none;
  transition: color 0.15s;
  cursor: pointer;
  line-height: 1.4;
  padding-left: 0;
}

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

.toc-link.active {
  color: var(--toc-active);
  font-weight: 500;
}

/* Indented layout for h3 in TOC */
.toc-link-h3 {
  padding-left: 12px;
}

.toc-empty {
  font-size: 0.8rem;
  color: var(--text-muted);
}

/* Tabbed Snippet Switcher classes */
.tab-snippet {
  margin-bottom: 1.5rem;
  border-radius: 8px;
  border: 1px solid var(--border-color);
  overflow: hidden;
}

.tab-nav {
  display: flex;
  background-color: var(--bg-secondary);
  border-bottom: 1px solid var(--border-color);
  padding: 0 8px;
}

.tab-nav-btn {
  background: none;
  border: none;
  color: var(--text-secondary);
  padding: 10px 16px;
  font-size: 0.78rem;
  font-weight: 500;
  cursor: pointer;
  border-bottom: 2px solid transparent;
  transition: all 0.15s;
}

.tab-nav-btn:hover {
  color: var(--text-primary);
}

.tab-nav-btn.active {
  color: var(--accent-color);
  border-bottom-color: var(--accent-color);
}

.tab-panel {
  display: none;
}

.tab-panel.active {
  display: block;
}

/* Search Modal Styles */
.search-overlay {
  position: fixed;
  top: 0;
  left: 0;
  width: 100vw;
  height: 100vh;
  background-color: rgba(0, 0, 0, 0.6);
  backdrop-filter: blur(4px);
  z-index: 2000;
  display: flex;
  justify-content: center;
  padding-top: 12vh;
  opacity: 0;
  pointer-events: none;
  transition: opacity 0.2s;
}

.search-overlay.active {
  opacity: 1;
  pointer-events: auto;
}

.search-modal {
  width: 90%;
  max-width: 600px;
  max-height: 70vh;
  background-color: var(--bg-secondary);
  border: 1px solid var(--border-color);
  border-radius: 12px;
  box-shadow: var(--shadow-md);
  display: flex;
  flex-direction: column;
  overflow: hidden;
  transform: translateY(-20px);
  transition: transform 0.2s;
}

.search-overlay.active .search-modal {
  transform: translateY(0);
}

.search-input-wrapper {
  display: flex;
  align-items: center;
  padding: 14px 18px;
  border-bottom: 1px solid var(--border-color);
}

.search-icon {
  color: var(--text-muted);
  margin-right: 12px;
}

#search-input {
  flex: 1;
  background: none;
  border: none;
  color: var(--text-primary);
  font-family: inherit;
  font-size: 0.95rem;
  outline: none;
}

.search-close-btn {
  background: none;
  border: none;
  color: var(--text-muted);
  cursor: pointer;
  padding: 4px;
  font-size: 1rem;
}

.search-close-btn:hover {
  color: var(--text-primary);
}

.search-results {
  flex: 1;
  overflow-y: auto;
  padding: 12px;
}

.search-item {
  display: block;
  text-decoration: none;
  padding: 12px;
  border-radius: 8px;
  color: var(--text-secondary);
  cursor: pointer;
  transition: all 0.2s;
  border: 1px solid transparent;
}

.search-item:hover, .search-item.selected {
  background-color: var(--bg-tertiary);
  color: var(--text-primary);
  border-color: var(--border-color);
}

.search-item-title {
  font-family: 'Outfit', sans-serif;
  font-weight: 600;
  font-size: 0.9rem;
  color: var(--text-primary);
  margin-bottom: 2px;
}

.search-item-context {
  font-size: 0.72rem;
  color: var(--text-muted);
  display: flex;
  align-items: center;
  gap: 5px;
}

.search-item-snippet {
  font-size: 0.78rem;
  margin-top: 4px;
  line-height: 1.4;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}

.search-item-snippet mark {
  background-color: rgba(var(--accent-rgb), 0.25);
  color: var(--text-primary);
  border-radius: 2px;
  padding: 0 2px;
}

.search-empty {
  text-align: center;
  color: var(--text-muted);
  padding: 40px 0;
  font-size: 0.88rem;
}

.search-footer {
  display: flex;
  gap: 16px;
  padding: 10px 18px;
  border-top: 1px solid var(--border-color);
  background-color: var(--bg-primary);
  font-size: 0.72rem;
  color: var(--text-muted);
}

.search-footer kbd {
  background-color: var(--kbd-bg);
  padding: 1px 4px;
  border-radius: 3px;
  border: 1px solid var(--border-color);
}

/* Responsive Breakpoints */
@media (max-width: 1100px) {
  .docs-toc {
    display: none; /* Hide TOC on smaller screens */
  }
  .docs-content-wrapper {
    margin-right: 0;
  }
}

@media (max-width: 768px) {
  .docs-sidebar {
    display: none; /* In a production app, we would make a responsive toggle.
                      For simplicity, we show a clean layout or side nav drawer. */
  }
  .docs-content-wrapper {
    margin-left: 0;
    padding: 24px 16px;
  }
  .search-trigger {
    min-width: unset;
    width: 40px;
    padding: 6px;
    justify-content: center;
  }
  .search-trigger span, .search-trigger kbd {
    display: none; /* Only show icon on mobile */
  }
  .header-left span {
    font-size: 1rem;
  }
}