/* ==========================================================================
   Docs-Specific Styles — Phase 2 Production
   Sidebar, ToC, doc content typography, admonitions, breadcrumbs, prev/next,
   homepage hero & cards, search modal, mobile responsive breakpoints.
   ========================================================================== */

/* ---------- Docs Layout (3-column) ---------- */
.docs-layout {
  display: grid;
  grid-template-columns: var(--sidebar-width) minmax(0, 1fr) var(--toc-width);
  max-width: 1400px;
  margin: 0 auto;
  min-height: calc(100vh - var(--header-height) - 80px);
}

/* Collapse ToC below 1200px */
@media (max-width: 1200px) {
  .docs-layout {
    grid-template-columns: var(--sidebar-width) minmax(0, 1fr);
  }
  .docs-toc {
    display: none;
  }
}

/* Collapse sidebar below 1024px */
@media (max-width: 1023px) {
  .docs-layout {
    grid-template-columns: minmax(0, 1fr);
  }
}

/* ==========================================================================
   SIDEBAR
   ========================================================================== */
.docs-sidebar {
  position: sticky;
  top: var(--header-height);
  height: calc(100vh - var(--header-height));
  overflow-y: auto;
  padding: 20px 12px 32px 16px;
  border-right: 1px solid var(--color-border-light);
  background: var(--color-bg);
  font-size: 0.875rem;
  transition: background-color var(--transition-slow), border-color var(--transition-slow);
  overscroll-behavior: contain;
}

/* Mobile sidebar: off-canvas drawer */
@media (max-width: 1023px) {
  .docs-sidebar {
    position: fixed;
    top: var(--header-height);
    left: 0;
    bottom: 0;
    width: var(--sidebar-width);
    z-index: 90;
    transform: translateX(-100%);
    transition: transform 0.25s cubic-bezier(0.4, 0, 0.2, 1),
      background-color var(--transition-slow);
    box-shadow: none;
    border-right: none;
  }

  .docs-sidebar.open {
    transform: translateX(0);
    box-shadow: var(--shadow-xl);
  }
}

/* Sidebar overlay backdrop (mobile) */
.sidebar-overlay {
  display: none;
}

@media (max-width: 1023px) {
  .sidebar-overlay.active {
    display: block;
    position: fixed;
    inset: 0;
    top: var(--header-height);
    z-index: 85;
    background: rgba(0, 0, 0, 0.45);
    animation: fadeIn 0.2s ease;
  }
}

@keyframes fadeIn {
  from { opacity: 0; }
  to { opacity: 1; }
}

/* --- Sidebar Section (collapsible <details>) --- */
.sidebar-section {
  margin-bottom: 2px;
}

.sidebar-section-title {
  display: flex;
  align-items: center;
  padding: 8px 10px;
  font-weight: 600;
  font-size: 0.82rem;
  color: var(--color-text);
  cursor: pointer;
  border-radius: var(--radius-sm);
  list-style: none;
  user-select: none;
  text-transform: uppercase;
  letter-spacing: 0.03em;
  transition: background-color var(--transition-fast), color var(--transition-fast);
}

/* Remove default marker */
.sidebar-section-title::-webkit-details-marker {
  display: none;
}

/* Custom chevron indicator */
.sidebar-section-title::before {
  content: '';
  display: inline-block;
  width: 16px;
  height: 16px;
  margin-right: 6px;
  flex-shrink: 0;
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 24 24' fill='none' stroke='%23888' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='9 18 15 12 9 6'/%3E%3C/svg%3E");
  background-size: 14px;
  background-repeat: no-repeat;
  background-position: center;
  transition: transform 0.2s ease;
}

.sidebar-section[open] > .sidebar-section-title::before {
  transform: rotate(90deg);
}

.sidebar-section-title:hover {
  background: var(--color-bg-light);
  color: var(--color-primary);
}

/* --- Sidebar items --- */
.sidebar-section-items {
  list-style: none;
  padding: 2px 0 8px 24px;
  margin: 0;
}

.sidebar-section-items li {
  margin-bottom: 1px;
}

.sidebar-section-items li a {
  display: block;
  padding: 5px 10px;
  color: var(--color-text-secondary);
  font-size: 0.85rem;
  font-weight: 400;
  border-radius: var(--radius-sm);
  border-left: 2px solid transparent;
  transition: background-color var(--transition-fast), color var(--transition-fast),
    border-color var(--transition-fast);
  line-height: 1.45;
}

.sidebar-section-items li a:hover {
  background: var(--color-bg-light);
  color: var(--color-text);
  text-decoration: none;
}

.sidebar-section-items li a.active {
  background: color-mix(in srgb, var(--color-primary) 8%, transparent);
  color: var(--color-primary);
  font-weight: 500;
  border-left-color: var(--color-primary);
}

/* ==========================================================================
   MAIN CONTENT AREA
   ========================================================================== */
.docs-main {
  padding: 28px 48px 72px;
  max-width: var(--content-max-width);
  width: 100%;
  min-width: 0; /* prevent grid blowout */
}

@media (max-width: 768px) {
  .docs-main {
    padding: 20px 20px 48px;
  }
}

/* ==========================================================================
   BREADCRUMBS
   ========================================================================== */
.breadcrumbs {
  margin-bottom: 24px;
}

.breadcrumb-list {
  display: flex;
  flex-wrap: wrap;
  list-style: none;
  gap: 2px;
  font-size: 0.82rem;
  color: var(--color-text-secondary);
  align-items: center;
}

.breadcrumb-list li {
  display: flex;
  align-items: center;
}

.breadcrumb-list li:not(:last-child)::after {
  content: '';
  display: inline-block;
  width: 14px;
  height: 14px;
  margin: 0 4px 0 6px;
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 24 24' fill='none' stroke='%23999' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='9 18 15 12 9 6'/%3E%3C/svg%3E");
  background-size: 12px;
  background-repeat: no-repeat;
  background-position: center;
  opacity: 0.6;
}

.breadcrumb-list li a {
  color: var(--color-text-secondary);
  transition: color var(--transition-fast);
}

.breadcrumb-list li a:hover {
  color: var(--color-primary);
  text-decoration: none;
}

.breadcrumb-list li[aria-current='page'] {
  color: var(--color-text);
  font-weight: 500;
}

/* ==========================================================================
   DOC CONTENT TYPOGRAPHY
   ========================================================================== */
.doc-content {
  line-height: 1.7;
  word-wrap: break-word;
  overflow-wrap: break-word;
}

/* --- Headings --- */
.doc-content h1 {
  font-size: 2rem;
  font-weight: 700;
  margin: 0 0 20px;
  line-height: 1.25;
  letter-spacing: -0.02em;
  color: var(--color-text);
}

.doc-content h2 {
  font-size: 1.5rem;
  font-weight: 600;
  margin: 48px 0 16px;
  padding-top: 24px;
  border-top: 1px solid var(--color-border-light);
  line-height: 1.3;
  letter-spacing: -0.01em;
  scroll-margin-top: calc(var(--header-height) + 24px);
}

.doc-content h2:first-child,
.doc-content h1 + h2 {
  border-top: none;
  margin-top: 28px;
  padding-top: 0;
}

.doc-content h3 {
  font-size: 1.2rem;
  font-weight: 600;
  margin: 32px 0 10px;
  line-height: 1.4;
  scroll-margin-top: calc(var(--header-height) + 24px);
}

.doc-content h4 {
  font-size: 1.05rem;
  font-weight: 600;
  margin: 24px 0 8px;
  line-height: 1.4;
  scroll-margin-top: calc(var(--header-height) + 24px);
}

/* Heading anchor links */
.doc-content h2[id],
.doc-content h3[id],
.doc-content h4[id] {
  position: relative;
  cursor: pointer;
}

.doc-content h2[id]:hover::before,
.doc-content h3[id]:hover::before,
.doc-content h4[id]:hover::before {
  content: '#';
  position: absolute;
  left: -1.2em;
  color: var(--color-primary);
  font-weight: 400;
  opacity: 0.6;
}

/* --- Paragraphs & lists --- */
.doc-content p {
  margin: 0 0 16px;
}

.doc-content ul,
.doc-content ol {
  margin: 0 0 16px;
  padding-left: 24px;
}

.doc-content li {
  margin-bottom: 6px;
  line-height: 1.6;
}

.doc-content li > ul,
.doc-content li > ol {
  margin-top: 6px;
  margin-bottom: 4px;
}

.doc-content strong {
  font-weight: 600;
  color: var(--color-text);
}

.doc-content em {
  font-style: italic;
}

/* --- Inline code --- */
.doc-content code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  padding: 2px 7px;
  background: var(--color-bg-light);
  border-radius: var(--radius-sm);
  border: 1px solid var(--color-border-light);
  white-space: nowrap;
  word-break: break-word;
}

/* --- Code blocks --- */
.doc-content pre {
  margin: 0 0 20px;
  padding: 18px 20px;
  background: var(--color-bg-light);
  border: 1px solid var(--color-border-light);
  border-radius: var(--radius-md);
  overflow-x: auto;
  font-size: 0.875rem;
  line-height: 1.6;
  position: relative;
}

.doc-content pre code {
  padding: 0;
  background: none;
  border: none;
  font-size: inherit;
  white-space: pre;
  word-break: normal;
}

[data-theme='dark'] .doc-content pre {
  background: #2a2a2a;
  border-color: #3a3a3a;
}

[data-theme='dark'] .doc-content code {
  background: #2a2a2a;
  border-color: #3a3a3a;
}

/* --- Tables --- */
.doc-content table {
  width: 100%;
  margin: 0 0 20px;
  border-collapse: collapse;
  font-size: 0.9rem;
  display: block;
  overflow-x: auto;
  -webkit-overflow-scrolling: touch;
}

.doc-content th,
.doc-content td {
  padding: 10px 16px;
  border: 1px solid var(--color-border-light);
  text-align: left;
  white-space: nowrap;
}

@media (min-width: 768px) {
  .doc-content table {
    display: table;
  }
  .doc-content th,
  .doc-content td {
    white-space: normal;
  }
}

.doc-content th {
  background: var(--color-bg-light);
  font-weight: 600;
  font-size: 0.85rem;
}

.doc-content tr:nth-child(even) td {
  background: var(--color-bg-subtle);
}

[data-theme='dark'] .doc-content tr:nth-child(even) td {
  background: #222;
}

/* --- Blockquotes --- */
.doc-content blockquote {
  margin: 0 0 20px;
  padding: 14px 20px;
  border-left: 4px solid var(--color-primary);
  background: var(--color-bg-light);
  color: var(--color-text-secondary);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  font-style: italic;
}

.doc-content blockquote p:last-child {
  margin-bottom: 0;
}

/* --- Horizontal rule --- */
.doc-content hr {
  border: none;
  border-top: 1px solid var(--color-border-light);
  margin: 40px 0;
}

/* --- Images / figures --- */
.doc-content img {
  border-radius: var(--radius-md);
  border: 1px solid var(--color-border-light);
  margin: 8px 0 20px;
  box-shadow: var(--shadow-sm);
}

.doc-content img[alt]:not([alt=""]) {
  /* images with alt text get a subtle treatment */
}

/* --- Links in content --- */
.doc-content a {
  color: var(--color-primary);
  text-decoration: underline;
  text-decoration-color: color-mix(in srgb, var(--color-primary) 30%, transparent);
  text-underline-offset: 2px;
  transition: color var(--transition-fast), text-decoration-color var(--transition-fast);
}

.doc-content a:hover {
  color: var(--color-primary-dark);
  text-decoration-color: var(--color-primary-dark);
}

/* --- Keyboard --- */
.doc-content kbd {
  font-family: var(--font-mono);
  font-size: 0.8em;
  padding: 2px 7px;
  background: var(--color-bg-light);
  border: 1px solid var(--color-border);
  border-bottom-width: 2px;
  border-radius: var(--radius-sm);
  white-space: nowrap;
}

/* --- Definition lists --- */
.doc-content dt {
  font-weight: 600;
  margin-top: 16px;
}

.doc-content dd {
  margin-left: 20px;
  margin-bottom: 8px;
  color: var(--color-text-secondary);
}

/* ==========================================================================
   ADMONITIONS — Note, Tip, Warning, Danger
   ========================================================================== */
.admonition {
  margin: 20px 0;
  padding: 16px 20px;
  border-radius: var(--radius-md);
  border-left: 4px solid;
  font-size: 0.92rem;
}

.admonition-title {
  display: flex;
  align-items: center;
  gap: 8px;
  font-weight: 600;
  font-size: 0.88rem;
  margin-bottom: 8px;
  text-transform: uppercase;
  letter-spacing: 0.03em;
}

.admonition-title::before {
  content: '';
  display: inline-block;
  width: 18px;
  height: 18px;
  flex-shrink: 0;
  background-size: 16px;
  background-repeat: no-repeat;
  background-position: center;
}

.admonition-content p:last-child {
  margin-bottom: 0;
}

.admonition-content code {
  font-size: 0.85em;
}

/* Note */
.admonition--note {
  background: #edf5fd;
  border-left-color: #0078d4;
}
.admonition--note .admonition-title {
  color: #0063b1;
}
.admonition--note .admonition-title::before {
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%230078d4' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Ccircle cx='12' cy='12' r='10'/%3E%3Cline x1='12' y1='16' x2='12' y2='12'/%3E%3Cline x1='12' y1='8' x2='12.01' y2='8'/%3E%3C/svg%3E");
}
[data-theme='dark'] .admonition--note {
  background: #152a42;
  border-left-color: #2b99ff;
}
[data-theme='dark'] .admonition--note .admonition-title {
  color: #5cb3ff;
}

/* Tip */
.admonition--tip {
  background: #ecf8ee;
  border-left-color: #2ea043;
}
.admonition--tip .admonition-title {
  color: #1a7f37;
}
.admonition--tip .admonition-title::before {
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%232ea043' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M9 18h6'/%3E%3Cpath d='M10 22h4'/%3E%3Cpath d='M12 2a7 7 0 0 0-4 12.7V17h8v-2.3A7 7 0 0 0 12 2z'/%3E%3C/svg%3E");
}
[data-theme='dark'] .admonition--tip {
  background: #162e1d;
  border-left-color: #3fb950;
}
[data-theme='dark'] .admonition--tip .admonition-title {
  color: #56d364;
}

/* Warning */
.admonition--warning {
  background: #fef6ea;
  border-left-color: #e68a00;
}
.admonition--warning .admonition-title {
  color: #bf7600;
}
.admonition--warning .admonition-title::before {
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%23e68a00' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M10.29 3.86L1.82 18a2 2 0 001.71 3h16.94a2 2 0 001.71-3L13.71 3.86a2 2 0 00-3.42 0z'/%3E%3Cline x1='12' y1='9' x2='12' y2='13'/%3E%3Cline x1='12' y1='17' x2='12.01' y2='17'/%3E%3C/svg%3E");
}
[data-theme='dark'] .admonition--warning {
  background: #332b14;
  border-left-color: #d29922;
}
[data-theme='dark'] .admonition--warning .admonition-title {
  color: #e3b341;
}

/* Danger */
.admonition--danger {
  background: #fdf0f0;
  border-left-color: #d73a49;
}
.admonition--danger .admonition-title {
  color: #cb2431;
}
.admonition--danger .admonition-title::before {
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='18' height='18' viewBox='0 0 24 24' fill='none' stroke='%23d73a49' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolygon points='7.86 2 16.14 2 22 7.86 22 16.14 16.14 22 7.86 22 2 16.14 2 7.86 7.86 2'/%3E%3Cline x1='12' y1='8' x2='12' y2='12'/%3E%3Cline x1='12' y1='16' x2='12.01' y2='16'/%3E%3C/svg%3E");
}
[data-theme='dark'] .admonition--danger {
  background: #321919;
  border-left-color: #f85149;
}
[data-theme='dark'] .admonition--danger .admonition-title {
  color: #ff7b72;
}

/* ==========================================================================
   TABLE OF CONTENTS (Desktop — right panel)
   ========================================================================== */
.docs-toc {
  position: sticky;
  top: var(--header-height);
  height: calc(100vh - var(--header-height));
  overflow-y: auto;
  padding: 28px 16px 28px 20px;
  border-left: 1px solid var(--color-border-light);
  font-size: 0.82rem;
  transition: border-color var(--transition-slow);
  overscroll-behavior: contain;
}

.toc-sticky {
  position: sticky;
  top: 28px;
}

.toc-heading {
  font-size: 0.72rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-text-muted);
  margin-bottom: 14px;
  padding-left: 10px;
}

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

.toc-list li {
  margin-bottom: 2px;
}

.toc-list li a {
  display: block;
  padding: 4px 10px;
  color: var(--color-text-secondary);
  border-left: 2px solid transparent;
  transition: color var(--transition-fast), border-color var(--transition-fast),
    background-color var(--transition-fast);
  border-radius: 0 var(--radius-xs) var(--radius-xs) 0;
  line-height: 1.45;
}

.toc-list li a:hover {
  color: var(--color-text);
  text-decoration: none;
  background: var(--color-bg-light);
}

.toc-list li a.active {
  color: var(--color-primary);
  border-left-color: var(--color-primary);
  font-weight: 500;
}

.toc-list li.toc-sub a {
  padding-left: 22px;
  font-size: 0.8rem;
}

/* ==========================================================================
   MOBILE TABLE OF CONTENTS
   ========================================================================== */
.toc-mobile {
  display: none;
  margin-bottom: 20px;
  border: 1px solid var(--color-border-light);
  border-radius: var(--radius-md);
  background: var(--color-bg-subtle);
  overflow: hidden;
}

@media (max-width: 1200px) {
  .toc-mobile {
    display: block;
  }
}

.toc-mobile summary {
  padding: 12px 16px;
  font-size: 0.85rem;
  font-weight: 600;
  cursor: pointer;
  user-select: none;
  color: var(--color-text-secondary);
  transition: color var(--transition-fast), background-color var(--transition-fast);
  list-style: none;
  display: flex;
  align-items: center;
  gap: 8px;
}

.toc-mobile summary::-webkit-details-marker {
  display: none;
}

.toc-mobile summary::before {
  content: '';
  display: inline-block;
  width: 14px;
  height: 14px;
  background-image: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' width='14' height='14' viewBox='0 0 24 24' fill='none' stroke='%23888' stroke-width='2' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='9 18 15 12 9 6'/%3E%3C/svg%3E");
  background-size: contain;
  background-repeat: no-repeat;
  transition: transform 0.2s ease;
}

.toc-mobile[open] summary::before {
  transform: rotate(90deg);
}

.toc-mobile summary:hover {
  color: var(--color-text);
  background: var(--color-bg-light);
}

.toc-mobile-nav {
  padding: 4px 16px 16px;
}

.toc-mobile-nav .toc-list li a {
  border-left: none;
  padding: 5px 10px;
  border-radius: var(--radius-sm);
}

.toc-mobile-nav .toc-list li a:hover {
  background: var(--color-bg-light);
}

/* ==========================================================================
   PREVIOUS / NEXT NAVIGATION
   ========================================================================== */
.prev-next {
  margin-top: 56px;
  padding-top: 28px;
  border-top: 1px solid var(--color-border-light);
}

.prev-next-links {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 16px;
}

@media (max-width: 480px) {
  .prev-next-links {
    grid-template-columns: 1fr;
  }
}

.prev-next-link {
  display: flex;
  flex-direction: column;
  gap: 4px;
  padding: 16px 20px;
  border: 1px solid var(--color-border-light);
  border-radius: var(--radius-md);
  transition: border-color var(--transition-normal), box-shadow var(--transition-normal),
    background-color var(--transition-fast);
  text-decoration: none !important;
}

.prev-next-link:hover {
  border-color: var(--color-primary);
  box-shadow: var(--shadow-sm);
  background: var(--color-bg-subtle);
}

.prev-next-link.empty {
  visibility: hidden;
}

.next-link {
  text-align: right;
}

.prev-next-direction {
  font-size: 0.78rem;
  color: var(--color-text-muted);
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.03em;
}

.prev-next-title {
  font-weight: 600;
  font-size: 0.95rem;
  color: var(--color-primary);
  transition: color var(--transition-fast);
}

.prev-next-link:hover .prev-next-title {
  color: var(--color-primary-dark);
}

/* ==========================================================================
   HOMEPAGE — Hero Section
   ========================================================================== */
.docs-hero {
  background: var(--gradient-brand);
  color: #ffffff;
  text-align: center;
  padding: 72px 24px 64px;
  position: relative;
  overflow: hidden;
}

/* Subtle pattern overlay */
.docs-hero::before {
  content: '';
  position: absolute;
  inset: 0;
  background: radial-gradient(circle at 20% 50%, rgba(255, 255, 255, 0.08) 0%, transparent 50%),
    radial-gradient(circle at 80% 50%, rgba(255, 255, 255, 0.05) 0%, transparent 50%);
  pointer-events: none;
}

.docs-hero-inner {
  max-width: 700px;
  margin: 0 auto;
  position: relative;
  z-index: 1;
}

.docs-hero .hero-logo {
  margin-bottom: 24px;
  border-radius: var(--radius-lg);
  filter: drop-shadow(0 4px 12px rgba(0, 0, 0, 0.15));
}

.docs-hero h1 {
  font-size: 2.4rem;
  font-weight: 700;
  margin-bottom: 14px;
  letter-spacing: -0.02em;
  line-height: 1.2;
  text-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
}

@media (max-width: 640px) {
  .docs-hero h1 {
    font-size: 1.8rem;
  }
  .docs-hero {
    padding: 48px 20px 44px;
  }
}

.docs-hero .hero-subtitle {
  font-size: 1.15rem;
  opacity: 0.92;
  margin-bottom: 32px;
  line-height: 1.5;
}

.hero-cta {
  display: inline-flex;
  align-items: center;
  gap: 8px;
  padding: 14px 36px;
  background: #ffffff;
  color: var(--color-primary-dark);
  font-weight: 600;
  font-size: 1.05rem;
  border-radius: var(--radius-md);
  transition: transform var(--transition-normal), box-shadow var(--transition-normal);
  box-shadow: 0 2px 8px rgba(0, 0, 0, 0.12);
}

.hero-cta:hover {
  text-decoration: none;
  transform: translateY(-2px);
  box-shadow: 0 6px 20px rgba(0, 0, 0, 0.2);
}

.hero-cta:active {
  transform: translateY(0);
}

/* ==========================================================================
   HOMEPAGE — Category Cards
   ========================================================================== */
.docs-categories {
  max-width: 1100px;
  margin: 0 auto;
  padding: 56px 24px 72px;
}

.categories-grid {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: 20px;
}

@media (max-width: 900px) {
  .categories-grid {
    grid-template-columns: repeat(2, 1fr);
  }
}

@media (max-width: 560px) {
  .categories-grid {
    grid-template-columns: 1fr;
    gap: 16px;
  }
}

.category-card {
  display: flex;
  flex-direction: column;
  padding: 28px 24px;
  border: 1px solid var(--color-border-light);
  border-radius: var(--radius-lg);
  background: var(--color-bg);
  transition: border-color var(--transition-normal), box-shadow var(--transition-normal),
    transform var(--transition-normal);
  text-decoration: none !important;
}

.category-card:hover {
  border-color: var(--color-primary);
  box-shadow: var(--shadow-md);
  transform: translateY(-3px);
}

.category-icon {
  width: 48px;
  height: 48px;
  display: flex;
  align-items: center;
  justify-content: center;
  background: color-mix(in srgb, var(--color-primary) 10%, transparent);
  border-radius: var(--radius-md);
  margin-bottom: 16px;
  color: var(--color-primary);
  transition: background-color var(--transition-normal), transform var(--transition-normal);
}

.category-card:hover .category-icon {
  background: color-mix(in srgb, var(--color-primary) 16%, transparent);
  transform: scale(1.05);
}

.category-card h2 {
  font-size: 1.1rem;
  font-weight: 600;
  color: var(--color-text);
  margin-bottom: 8px;
  line-height: 1.3;
}

.category-card p {
  font-size: 0.9rem;
  color: var(--color-text-secondary);
  line-height: 1.55;
  margin: 0;
  flex-grow: 1;
}

/* ==========================================================================
   SEARCH MODAL
   ========================================================================== */
.search-modal {
  position: fixed;
  inset: 0;
  z-index: 200;
  display: flex;
  align-items: flex-start;
  justify-content: center;
  padding-top: 12vh;
}

.search-modal[hidden] {
  display: none;
}

.search-modal-backdrop {
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.5);
  animation: fadeIn 0.15s ease;
}

[data-theme='dark'] .search-modal-backdrop {
  background: rgba(0, 0, 0, 0.65);
}

.search-modal-content {
  position: relative;
  width: 90%;
  max-width: 600px;
  background: var(--color-bg);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-lg);
  box-shadow: var(--shadow-xl);
  overflow: hidden;
  animation: slideDown 0.2s ease;
}

@keyframes slideDown {
  from {
    opacity: 0;
    transform: translateY(-10px);
  }
  to {
    opacity: 1;
    transform: translateY(0);
  }
}

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

.search-input-wrapper svg {
  flex-shrink: 0;
  color: var(--color-text-muted);
}

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

.search-input::placeholder {
  color: var(--color-text-muted);
}

.search-results {
  max-height: 50vh;
  overflow-y: auto;
  padding: 8px;
}

.search-result-item {
  display: block;
  padding: 12px 16px;
  border-radius: var(--radius-sm);
  color: var(--color-text);
  transition: background-color var(--transition-fast);
  text-decoration: none !important;
}

.search-result-item:hover {
  background: var(--color-bg-light);
}

.search-result-item + .search-result-item {
  margin-top: 2px;
}

.search-result-title {
  font-weight: 600;
  font-size: 0.92rem;
  margin-bottom: 2px;
}

.search-result-section {
  font-size: 0.78rem;
  color: var(--color-primary);
  font-weight: 500;
}

.search-result-excerpt {
  font-size: 0.82rem;
  color: var(--color-text-secondary);
  margin-top: 4px;
  line-height: 1.4;
}

.search-no-results {
  padding: 28px 20px;
  text-align: center;
  color: var(--color-text-muted);
  font-size: 0.9rem;
}

/* ==========================================================================
   MOBILE RESPONSIVE FINE-TUNING
   ========================================================================== */
@media (max-width: 1023px) {
  .header-nav {
    display: none;
  }
}

@media (max-width: 480px) {
  .header-inner {
    padding: 0 16px;
    gap: 12px;
  }

  .search-shortcut {
    display: none;
  }

  .docs-hero h1 {
    font-size: 1.6rem;
  }

  .docs-hero .hero-subtitle {
    font-size: 1rem;
  }

  .hero-cta {
    padding: 12px 28px;
    font-size: 0.95rem;
  }

  .categories-grid {
    padding: 0;
  }

  .category-card {
    padding: 22px 20px;
  }
}

/* ==========================================================================
   BACK-TO-TOP BUTTON (optional enhancement)
   ========================================================================== */
.back-to-top {
  position: fixed;
  bottom: 24px;
  right: 24px;
  z-index: 50;
  width: 40px;
  height: 40px;
  border-radius: 50%;
  background: var(--color-primary);
  color: #fff;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: var(--shadow-md);
  opacity: 0;
  pointer-events: none;
  transition: opacity var(--transition-normal), transform var(--transition-normal);
  cursor: pointer;
  border: none;
}

.back-to-top.visible {
  opacity: 1;
  pointer-events: auto;
}

.back-to-top:hover {
  transform: translateY(-2px);
  box-shadow: var(--shadow-lg);
}

/* ==========================================================================
   HOMEPAGE BODY CLASS
   ========================================================================== */
.homepage-body .site-footer {
  margin-top: 0;
}

/* ==========================================================================
   PHASE 3: CODE BLOCK COPY BUTTON
   ========================================================================== */
.copy-code-btn {
  position: absolute;
  top: 8px;
  right: 8px;
  display: flex;
  align-items: center;
  justify-content: center;
  width: 32px;
  height: 32px;
  border: 1px solid var(--color-border-light);
  border-radius: var(--radius-sm);
  background: var(--color-bg);
  color: var(--color-text-muted);
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--transition-fast), background-color var(--transition-fast),
    color var(--transition-fast), border-color var(--transition-fast);
  z-index: 2;
}

.doc-content pre:hover .copy-code-btn {
  opacity: 1;
}

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

.copy-code-btn:focus-visible {
  opacity: 1;
}

.copy-code-btn.copied {
  color: #2ea043;
  border-color: #2ea043;
  opacity: 1;
}

[data-theme='dark'] .copy-code-btn {
  background: #2a2a2a;
  border-color: #3a3a3a;
}

[data-theme='dark'] .copy-code-btn:hover {
  background: #333;
  color: var(--color-text);
}

[data-theme='dark'] .copy-code-btn.copied {
  color: #3fb950;
  border-color: #3fb950;
}

/* ==========================================================================
   PHASE 3: SEARCH ENHANCEMENTS
   ========================================================================== */
/* Search result keyboard selection */
.search-result-item.selected {
  background: var(--color-bg-light);
  outline: 2px solid var(--color-primary);
  outline-offset: -2px;
}

/* Search term highlighting */
.search-highlight {
  background: color-mix(in srgb, var(--color-primary) 20%, transparent);
  color: var(--color-primary-dark);
  padding: 1px 2px;
  border-radius: 2px;
  font-weight: 500;
}

[data-theme='dark'] .search-highlight {
  background: color-mix(in srgb, var(--color-primary) 25%, transparent);
  color: var(--color-primary-light);
}

/* Improved no-results state */
.search-no-results {
  padding: 36px 20px;
  text-align: center;
  color: var(--color-text-muted);
  font-size: 0.9rem;
  display: flex;
  flex-direction: column;
  align-items: center;
  gap: 2px;
}

.search-no-results svg {
  margin-bottom: 4px;
}

.search-no-results strong {
  color: var(--color-text-secondary);
}

/* Search footer hint */
.search-footer {
  padding: 8px 16px;
  border-top: 1px solid var(--color-border-light);
  font-size: 0.75rem;
  color: var(--color-text-muted);
  display: flex;
  gap: 16px;
  align-items: center;
}

.search-footer kbd {
  font-family: var(--font-mono);
  font-size: 0.7rem;
  padding: 1px 5px;
  background: var(--color-bg-light);
  border: 1px solid var(--color-border-light);
  border-radius: var(--radius-xs);
}

/* ==========================================================================
   PHASE 3: TOAST NOTIFICATION
   ========================================================================== */
.docs-toast {
  position: fixed;
  bottom: 24px;
  left: 50%;
  transform: translateX(-50%) translateY(20px);
  background: var(--color-text);
  color: var(--color-bg);
  padding: 10px 20px;
  border-radius: var(--radius-md);
  font-size: 0.85rem;
  font-weight: 500;
  box-shadow: var(--shadow-lg);
  z-index: 300;
  opacity: 0;
  transition: opacity 0.2s ease, transform 0.2s ease;
  pointer-events: none;
  white-space: nowrap;
}

.docs-toast.visible {
  opacity: 1;
  transform: translateX(-50%) translateY(0);
}

/* ==========================================================================
   PHASE 3: EXTERNAL LINK ICON
   ========================================================================== */
.doc-content .external-icon svg {
  opacity: 0.5;
  transition: opacity var(--transition-fast);
}

.doc-content a:hover .external-icon svg {
  opacity: 0.8;
}

/* ==========================================================================
   PHASE 3: HEADING ANCHOR CLICK FEEDBACK
   ========================================================================== */
.doc-content h2[id],
.doc-content h3[id],
.doc-content h4[id] {
  cursor: pointer;
  transition: color var(--transition-fast);
}

.doc-content h2[id]:active,
.doc-content h3[id]:active,
.doc-content h4[id]:active {
  color: var(--color-primary);
}

/* ==========================================================================
   PHASE 3: TOC HIDDEN STATE
   ========================================================================== */
.docs-toc.hidden {
  display: none;
}