/* ==========================================================================
   VIUCraft Documentation Styles
   Uses design tokens from variables.css
   ========================================================================== */

/* ---------- Docs header (sticky sub-nav) ---------- */
.docs-header {
    position: sticky;
    top: 64px;
    z-index: var(--z-sticky);
    background: #fff;
    border-bottom: 1px solid var(--neutral-200);
    transition: box-shadow var(--transition-base);
}

.docs-header.has-shadow {
    box-shadow: var(--shadow-sm);
}

.docs-header-inner {
    max-width: 1200px;
    margin: 0 auto;
    padding: var(--space-8) var(--space-24);
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.docs-header-title {
    font-size: var(--font-size-lg);
    font-weight: 600;
    color: var(--neutral-900);
    margin: 0;
}

.docs-header-search {
    display: flex;
    align-items: center;
}

.docs-header-search .form-control {
    width: 220px;
    font-size: var(--font-size-sm);
    border-radius: var(--radius-sm) 0 0 var(--radius-sm);
    border-color: var(--neutral-200);
    background: var(--neutral-50);
}

.docs-header-search .form-control:focus {
    background: #fff;
}

.docs-header-search .btn {
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
    padding: 0.65rem 0.85rem;
}

.docs-header-nav {
    max-width: 1200px;
    margin: 0 auto;
    padding: 0 var(--space-24) var(--space-4);
    display: flex;
    gap: var(--space-4);
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    scrollbar-width: none;
}

.docs-header-nav::-webkit-scrollbar {
    display: none;
}

.docs-header-nav a {
    display: inline-block;
    padding: var(--space-4) var(--space-12);
    border-radius: 999px;
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--neutral-600);
    text-decoration: none;
    white-space: nowrap;
    transition: background var(--transition-fast), color var(--transition-fast);
}

.docs-header-nav a:hover {
    background: var(--neutral-100);
    color: var(--neutral-900);
}

.docs-header-nav a.active {
    background: rgba(113, 97, 239, 0.1);
    color: var(--primary-purple);
}

.docs-header-nav a i {
    margin-right: 4px;
    font-size: 0.85em;
}

/* ---------- Docs layout ---------- */
.docs-page {
    min-height: calc(100vh - 180px);
    background: var(--neutral-50);
}

.docs-container {
    display: flex;
    gap: var(--space-32);
    max-width: 1200px;
    margin: 0 auto;
    padding: var(--space-20) var(--space-24) var(--space-32);
}

.docs-content {
    flex: 1;
    min-width: 0;
}

.docs-content-narrow {
    max-width: 780px;
}

/* ---------- TOC sidebar ---------- */
.docs-toc {
    width: 240px;
    flex-shrink: 0;
    position: sticky;
    top: 160px;
    align-self: flex-start;
    max-height: calc(100vh - 200px);
    overflow-y: auto;
    padding-left: var(--space-24);
    border-left: 1px solid var(--neutral-200);
}

.docs-toc h6 {
    font-size: var(--font-size-xs);
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--neutral-500);
    margin-bottom: var(--space-12);
}

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

.docs-toc li {
    margin-bottom: var(--space-8);
}

.docs-toc li.toc-h3 {
    padding-left: var(--space-16);
}

.docs-toc a {
    font-size: var(--font-size-sm);
    color: var(--neutral-600);
    text-decoration: none;
    transition: color var(--transition-fast);
    line-height: 1.4;
}

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

/* ---------- Article typography ---------- */
.docs-content h1 {
    font-size: var(--font-size-3xl);
    font-weight: 700;
    color: var(--neutral-900);
    margin-bottom: var(--space-12);
    line-height: 1.2;
}

.docs-content h2 {
    font-size: var(--font-size-2xl);
    font-weight: 600;
    color: var(--neutral-900);
    margin-top: var(--space-32);
    margin-bottom: var(--space-12);
    line-height: 1.3;
}

.docs-content h3 {
    font-size: var(--font-size-xl);
    font-weight: 600;
    color: var(--neutral-900);
    margin-top: var(--space-32);
    margin-bottom: var(--space-12);
    line-height: 1.3;
}

.docs-content p {
    line-height: 1.7;
    color: var(--neutral-700);
}

.docs-content img {
    max-width: 100%;
    height: auto;
    border: 1px solid var(--neutral-200);
    border-radius: var(--radius-sm);
}

.docs-content blockquote {
    border-left: 4px solid var(--primary-purple);
    padding: var(--space-12) var(--space-20);
    margin: var(--space-24) 0;
    background: rgba(113, 97, 239, 0.04);
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
    color: var(--neutral-700);
}

.docs-content blockquote p {
    margin: 0;
}

.docs-content table {
    width: 100%;
    border-collapse: collapse;
    margin: var(--space-24) 0;
    font-size: var(--font-size-sm);
}

.docs-content table th,
.docs-content table td {
    padding: var(--space-12) var(--space-16);
    border: 1px solid var(--neutral-200);
    text-align: left;
}

.docs-content table th {
    background: var(--neutral-100);
    font-weight: 600;
    color: var(--neutral-800);
}

.docs-content table tr:hover td {
    background: var(--neutral-50);
}

.docs-content ul,
.docs-content ol {
    padding-left: var(--space-24);
    line-height: 1.7;
    color: var(--neutral-700);
}

.docs-content li {
    margin-bottom: var(--space-4);
}

/* ---------- Code blocks ---------- */
.docs-content pre {
    background: #1e1e2e;
    color: #cdd6f4;
    padding: var(--space-20);
    border-radius: var(--radius-md);
    overflow-x: auto;
    font-family: 'SF Mono', 'Fira Code', 'Courier New', monospace;
    font-size: 0.85rem;
    line-height: 1.7;
    margin: var(--space-24) 0;
    box-shadow: var(--shadow-md);
}

.docs-content pre code {
    background: none;
    padding: 0;
    color: inherit;
    font-size: inherit;
    border-radius: 0;
}

.docs-content code {
    background: rgba(113, 97, 239, 0.08);
    color: var(--primary-purple);
    padding: 2px 6px;
    border-radius: 4px;
    font-size: 0.875em;
    font-family: 'SF Mono', 'Fira Code', 'Courier New', monospace;
}

/* ---------- Breadcrumbs ---------- */
.docs-breadcrumb {
    padding: 0;
    margin-bottom: var(--space-12);
    background: none;
    font-size: var(--font-size-sm);
}

.docs-breadcrumb .breadcrumb-item a {
    color: var(--neutral-500);
    text-decoration: none;
    transition: color var(--transition-fast);
}

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

.docs-breadcrumb .breadcrumb-item.active {
    color: var(--neutral-700);
}

.docs-breadcrumb .breadcrumb-item + .breadcrumb-item::before {
    color: var(--neutral-400);
}

/* ---------- Article meta & tags ---------- */
.docs-article-meta {
    display: flex;
    align-items: center;
    gap: var(--space-16);
    font-size: var(--font-size-sm);
    color: var(--neutral-500);
}

.docs-tag {
    display: inline-block;
    padding: var(--space-4) var(--space-12);
    border-radius: 999px;
    font-size: var(--font-size-xs);
    font-weight: 500;
    background: rgba(113, 97, 239, 0.08);
    color: var(--primary-purple);
    text-decoration: none;
    transition: background var(--transition-fast);
}

.docs-tag:hover {
    background: rgba(113, 97, 239, 0.16);
    color: var(--primary-purple);
}

.docs-tag-active {
    background: var(--primary-purple);
    color: #fff;
}

.docs-tag-active:hover {
    background: var(--primary-purple);
    color: #fff;
    opacity: 0.9;
}

/* ---------- Cards (shared) ---------- */
.docs-article-card {
    background: #fff;
    border-radius: var(--radius-md);
    border: 1px solid var(--neutral-200);
    padding: var(--space-24);
    height: 100%;
    transition: box-shadow var(--transition-base), transform var(--transition-base);
}

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

.docs-article-card h5 {
    font-size: var(--font-size-base);
    font-weight: 600;
    margin-bottom: var(--space-8);
}

.docs-article-card h5 a {
    color: var(--neutral-900);
    text-decoration: none;
    transition: color var(--transition-fast);
}

.docs-article-card h5 a:hover {
    color: var(--primary-purple);
}

.docs-article-card p {
    color: var(--neutral-600);
    font-size: var(--font-size-sm);
    line-height: 1.6;
    margin-bottom: var(--space-8);
}

/* ---------- Stat cards (index page) ---------- */
.docs-stat-card {
    background: #fff;
    border-radius: var(--radius-md);
    border: 1px solid var(--neutral-200);
    padding: var(--space-24);
    display: flex;
    align-items: center;
    gap: var(--space-16);
    height: 100%;
    transition: box-shadow var(--transition-base), transform var(--transition-base);
}

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

.docs-stat-icon {
    width: 52px;
    height: 52px;
    border-radius: var(--radius-md);
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 1.25rem;
    flex-shrink: 0;
}

.docs-stat-icon-blue {
    background: rgba(66, 104, 230, 0.1);
    color: var(--primary-blue);
}

.docs-stat-icon-green {
    background: rgba(54, 179, 126, 0.1);
    color: var(--primary-green);
}

.docs-stat-icon-teal {
    background: rgba(0, 188, 212, 0.1);
    color: var(--primary-teal);
}

.docs-stat-icon-orange {
    background: rgba(255, 171, 0, 0.1);
    color: var(--primary-orange);
}

.docs-stat-info h5 {
    font-size: var(--font-size-sm);
    font-weight: 600;
    color: var(--neutral-800);
    margin-bottom: var(--space-4);
}

.docs-stat-info p {
    font-size: var(--font-size-sm);
    color: var(--neutral-500);
    margin-bottom: var(--space-8);
}

.docs-stat-link {
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--primary-purple);
    text-decoration: none;
    transition: color var(--transition-fast);
}

.docs-stat-link:hover {
    color: var(--primary-blue);
}

/* ---------- Category cards (index page) ---------- */
.docs-category-card {
    background: #fff;
    border-radius: var(--radius-md);
    border: 1px solid var(--neutral-200);
    overflow: hidden;
    height: 100%;
    transition: box-shadow var(--transition-base), transform var(--transition-base);
}

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

.docs-category-card-header {
    padding: var(--space-16) var(--space-20);
    border-bottom: 1px solid var(--neutral-200);
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.docs-category-card-header h5 {
    font-size: var(--font-size-base);
    font-weight: 600;
    margin: 0;
    color: var(--neutral-900);
}

.docs-category-badge {
    font-size: var(--font-size-xs);
    font-weight: 500;
    padding: var(--space-2) var(--space-8);
    border-radius: 999px;
    background: var(--neutral-100);
    color: var(--neutral-600);
}

.docs-category-card-body {
    padding: var(--space-20);
}

.docs-category-card-body p {
    color: var(--neutral-600);
    font-size: var(--font-size-sm);
    line-height: 1.6;
    margin-bottom: var(--space-12);
}

.docs-category-card-body ul {
    padding-left: var(--space-16);
    margin-bottom: var(--space-16);
}

.docs-category-card-body li {
    margin-bottom: var(--space-4);
}

.docs-category-card-body li a {
    font-size: var(--font-size-sm);
    color: var(--neutral-700);
    text-decoration: none;
    transition: color var(--transition-fast);
}

.docs-category-card-body li a:hover {
    color: var(--primary-purple);
}

.docs-category-browse {
    display: inline-flex;
    align-items: center;
    gap: var(--space-4);
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--primary-purple);
    text-decoration: none;
    padding: var(--space-4) var(--space-12);
    border: 1px solid rgba(113, 97, 239, 0.3);
    border-radius: var(--radius-sm);
    transition: background var(--transition-fast), border-color var(--transition-fast);
}

.docs-category-browse:hover {
    background: rgba(113, 97, 239, 0.06);
    border-color: var(--primary-purple);
    color: var(--primary-purple);
}

/* ---------- Audience link cards (index sidebar) ---------- */
.docs-audience-link {
    display: flex;
    align-items: center;
    gap: var(--space-12);
    padding: var(--space-12);
    border-radius: var(--radius-sm);
    text-decoration: none;
    color: var(--neutral-700);
    transition: background var(--transition-fast);
}

.docs-audience-link:hover {
    background: rgba(113, 97, 239, 0.06);
    color: var(--neutral-900);
}

.docs-audience-icon {
    width: 40px;
    height: 40px;
    border-radius: var(--radius-sm);
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 1.1rem;
    flex-shrink: 0;
}

.docs-audience-icon-dev {
    background: rgba(66, 104, 230, 0.1);
    color: var(--primary-blue);
}

.docs-audience-icon-biz {
    background: rgba(54, 179, 126, 0.1);
    color: var(--primary-green);
}

.docs-audience-icon-content {
    background: rgba(0, 188, 212, 0.1);
    color: var(--primary-teal);
}

.docs-audience-icon-admin {
    background: rgba(255, 171, 0, 0.1);
    color: var(--primary-orange);
}

.docs-audience-link h6 {
    font-size: var(--font-size-sm);
    font-weight: 600;
    margin-bottom: 2px;
    color: var(--neutral-800);
}

.docs-audience-link p {
    font-size: var(--font-size-xs);
    color: var(--neutral-500);
    margin: 0;
}

/* ---------- Recent article items (index sidebar) ---------- */
.docs-recent-item {
    padding: var(--space-12);
    border-radius: var(--radius-sm);
    background: #fff;
    border: 1px solid var(--neutral-200);
    margin-bottom: var(--space-8);
    transition: box-shadow var(--transition-fast), transform var(--transition-fast);
}

.docs-recent-item:hover {
    box-shadow: var(--shadow-sm);
    transform: translateY(-1px);
}

.docs-recent-item h6 {
    font-size: var(--font-size-sm);
    font-weight: 600;
    margin-bottom: var(--space-4);
}

.docs-recent-item h6 a {
    color: var(--neutral-800);
    text-decoration: none;
    transition: color var(--transition-fast);
}

.docs-recent-item h6 a:hover {
    color: var(--primary-purple);
}

.docs-recent-meta {
    display: flex;
    justify-content: space-between;
    align-items: center;
}

.docs-recent-badge {
    font-size: var(--font-size-xs);
    padding: 2px 8px;
    border-radius: 999px;
    background: var(--neutral-100);
    color: var(--neutral-600);
}

.docs-recent-date {
    font-size: var(--font-size-xs);
    color: var(--neutral-500);
}

/* ---------- Index hero ---------- */
.docs-hero {
    position: relative;
    padding: var(--space-48) 0;
    background: var(--gradient-hero);
    overflow: hidden;
}

.docs-hero::before {
    content: "";
    position: absolute;
    inset: 0;
    background-image: radial-gradient(circle, var(--neutral-300) 1px, transparent 1px);
    background-size: 28px 28px;
    opacity: 0.5;
    pointer-events: none;
}

.docs-hero-inner {
    position: relative;
    z-index: 1;
    max-width: 720px;
    margin: 0 auto;
    padding: 0 var(--space-24);
    text-align: center;
}

.docs-hero h1 {
    font-size: clamp(1.75rem, 4vw, 2.5rem);
    font-weight: 700;
    color: var(--neutral-900);
    margin-bottom: var(--space-12);
    line-height: 1.2;
}

.docs-hero p {
    font-size: var(--font-size-lg);
    color: var(--neutral-600);
    margin-bottom: var(--space-24);
    max-width: 520px;
    margin-left: auto;
    margin-right: auto;
}

.docs-hero-search {
    max-width: 560px;
    margin: 0 auto;
}

.docs-hero-search .input-group {
    box-shadow: var(--shadow-lg);
    border-radius: var(--radius-md);
    overflow: hidden;
}

.docs-hero-search .form-control {
    border: none;
    padding: var(--space-16) var(--space-20);
    font-size: var(--font-size-base);
}

.docs-hero-search .form-control:focus {
    box-shadow: none;
}

.docs-hero-search .btn {
    padding: var(--space-16) var(--space-24);
    font-weight: 600;
}

/* ---------- Index section headers ---------- */
.docs-section-title {
    font-size: var(--font-size-xl);
    font-weight: 600;
    color: var(--neutral-900);
    margin-bottom: var(--space-24);
    padding-bottom: var(--space-12);
    border-bottom: 1px solid var(--neutral-200);
    display: flex;
    align-items: center;
    gap: var(--space-8);
}

.docs-section-title i {
    color: var(--primary-purple);
}

/* ---------- Sidebar cards (index page) ---------- */
.docs-sidebar-card {
    background: #fff;
    border-radius: var(--radius-md);
    border: 1px solid var(--neutral-200);
    overflow: hidden;
    margin-bottom: var(--space-24);
}

.docs-sidebar-card-header {
    padding: var(--space-16) var(--space-20);
    border-bottom: 1px solid var(--neutral-200);
}

.docs-sidebar-card-header h5 {
    font-size: var(--font-size-sm);
    font-weight: 600;
    color: var(--neutral-900);
    margin: 0;
    display: flex;
    align-items: center;
    gap: var(--space-8);
}

.docs-sidebar-card-header h5 i {
    color: var(--primary-purple);
}

.docs-sidebar-card-body {
    padding: var(--space-12);
}

/* ---------- Search page ---------- */
.docs-search-box {
    background: #fff;
    border-radius: var(--radius-md);
    border: 1px solid var(--neutral-200);
    padding: var(--space-24);
    margin-bottom: var(--space-32);
}

.docs-search-result {
    display: block;
    background: #fff;
    border-radius: var(--radius-md);
    border: 1px solid var(--neutral-200);
    padding: var(--space-20);
    margin-bottom: var(--space-12);
    text-decoration: none;
    color: inherit;
    transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}

.docs-search-result:hover {
    border-color: var(--primary-purple);
    box-shadow: var(--shadow-sm);
    color: inherit;
}

.docs-search-result h5 {
    font-size: var(--font-size-base);
    font-weight: 600;
    color: var(--neutral-900);
    margin-bottom: var(--space-4);
}

.docs-search-result p {
    font-size: var(--font-size-sm);
    color: var(--neutral-600);
    margin-bottom: var(--space-8);
}

.docs-search-result .docs-tag {
    font-size: 11px;
    padding: 2px 8px;
}

.docs-search-category {
    font-size: var(--font-size-xs);
    color: var(--neutral-500);
}

/* ---------- Feedback section ---------- */
.docs-feedback {
    margin-top: var(--space-48);
    padding-top: var(--space-24);
    border-top: 1px solid var(--neutral-200);
}

.docs-feedback h4 {
    font-size: var(--font-size-lg);
    font-weight: 600;
    color: var(--neutral-800);
    margin-bottom: var(--space-16);
}

.docs-feedback .btn-group .btn {
    border-radius: var(--radius-sm);
    padding: var(--space-8) var(--space-16);
    font-size: var(--font-size-sm);
}

.docs-feedback .btn-group .btn:first-child {
    border-radius: var(--radius-sm) 0 0 var(--radius-sm);
}

.docs-feedback .btn-group .btn:last-child {
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
}

/* ---------- Prev / next navigation ---------- */
.docs-nav-prev-next {
    margin-top: var(--space-40);
    padding-top: var(--space-24);
    border-top: 1px solid var(--neutral-200);
}

.docs-nav-link {
    display: block;
    padding: var(--space-16) var(--space-20);
    border: 1px solid var(--neutral-200);
    border-radius: var(--radius-md);
    text-decoration: none;
    color: var(--neutral-700);
    transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}

.docs-nav-link:hover {
    border-color: var(--primary-purple);
    box-shadow: var(--shadow-sm);
    color: var(--neutral-900);
}

.docs-nav-label {
    display: block;
    font-size: var(--font-size-xs);
    color: var(--neutral-500);
    margin-bottom: var(--space-4);
}

.docs-nav-title {
    font-size: var(--font-size-sm);
    font-weight: 600;
    color: var(--neutral-800);
}

/* ---------- Related articles ---------- */
.docs-related {
    margin-top: var(--space-40);
    padding-top: var(--space-24);
    border-top: 1px solid var(--neutral-200);
}

.docs-related h4 {
    font-size: var(--font-size-lg);
    font-weight: 600;
    color: var(--neutral-800);
    margin-bottom: var(--space-16);
}

/* ---------- Back link ---------- */
.docs-back-link {
    display: inline-flex;
    align-items: center;
    gap: var(--space-8);
    padding: var(--space-8) var(--space-16);
    border: 1px solid var(--neutral-300);
    border-radius: var(--radius-sm);
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--neutral-600);
    text-decoration: none;
    transition: border-color var(--transition-fast), color var(--transition-fast);
}

.docs-back-link:hover {
    border-color: var(--primary-purple);
    color: var(--primary-purple);
}

/* ---------- View all button ---------- */
.docs-view-all {
    display: block;
    width: 100%;
    text-align: center;
    padding: var(--space-8) var(--space-16);
    border: 1px solid var(--neutral-200);
    border-radius: var(--radius-sm);
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--primary-purple);
    text-decoration: none;
    transition: background var(--transition-fast), border-color var(--transition-fast);
    margin-top: var(--space-8);
}

.docs-view-all:hover {
    background: rgba(113, 97, 239, 0.04);
    border-color: var(--primary-purple);
    color: var(--primary-purple);
}

/* ---------- Empty state ---------- */
.docs-empty {
    padding: var(--space-24);
    border-radius: var(--radius-md);
    background: rgba(66, 104, 230, 0.06);
    color: var(--primary-blue);
    font-size: var(--font-size-sm);
}

/* ---------- Docs home page (enhanced) ---------- */
.docs-home {
    max-width: 900px;
    margin: 0 auto;
}

.section-title {
    font-size: var(--font-size-lg);
    font-weight: 700;
    margin-bottom: var(--space-16);
    color: var(--neutral-900);
}

/* Audience entry points */
.docs-audiences {
    margin-bottom: var(--space-32);
}

.audience-cards {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
    gap: var(--space-16);
}

.audience-card {
    display: block;
    padding: var(--space-20);
    border-radius: var(--radius-md);
    text-decoration: none;
    color: inherit;
    border: 1px solid var(--neutral-200);
    background: #fff;
    transition: transform var(--transition-base), box-shadow var(--transition-base);
}

.audience-card:hover {
    transform: translateY(-2px);
    box-shadow: var(--shadow-md);
    color: inherit;
    text-decoration: none;
}

.audience-card.active {
    transform: translateY(-2px);
    box-shadow: var(--shadow-md);
    color: inherit;
    text-decoration: none;
    border-color: var(--primary-blue);
    background: rgba(66, 104, 230, 0.05);
}

.audience-dev {
    border-left: 4px solid #4F46E5;
}

.audience-biz {
    border-left: 4px solid #059669;
}

.audience-content {
    border-left: 4px solid #0891B2;
}

.audience-admin {
    border-left: 4px solid #D97706;
}

.audience-icon {
    font-size: 1.5rem;
    margin-bottom: var(--space-12);
}

.audience-dev .audience-icon {
    color: #4F46E5;
}

.audience-biz .audience-icon {
    color: #059669;
}

.audience-content .audience-icon {
    color: #0891B2;
}

.audience-admin .audience-icon {
    color: #D97706;
}

.audience-card h3 {
    font-size: var(--font-size-base);
    font-weight: 700;
    margin: 0 0 var(--space-4);
    color: var(--neutral-900);
}

.audience-card p {
    font-size: var(--font-size-sm);
    color: var(--neutral-500);
    margin: 0;
    line-height: 1.5;
}

/* Category grid browse */
.docs-categories-grid {
    margin-bottom: var(--space-32);
}

.category-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
    gap: var(--space-16);
}

.category-card {
    display: block;
    padding: var(--space-20);
    border-radius: var(--radius-md);
    text-decoration: none;
    color: inherit;
    border: 1px solid var(--neutral-200);
    background: #fff;
    transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}

.category-card:hover {
    border-color: var(--primary-purple);
    box-shadow: var(--shadow-sm);
    color: inherit;
    text-decoration: none;
}

.category-icon {
    font-size: 1.3rem;
    color: var(--primary-purple);
    margin-bottom: var(--space-8);
}

.category-card h3 {
    font-size: 0.95rem;
    font-weight: 700;
    margin: 0 0 var(--space-4);
    color: var(--neutral-900);
}

.category-card p {
    font-size: var(--font-size-sm);
    color: var(--neutral-500);
    margin: 0 0 var(--space-8);
    line-height: 1.5;
}

.category-count {
    font-size: var(--font-size-xs);
    color: var(--text-secondary);
}

/* Recently updated articles */
.docs-recent {
    margin-bottom: var(--space-24);
}

.recent-list {
    display: flex;
    flex-direction: column;
    gap: var(--space-12);
}

.recent-item {
    display: block;
    padding: var(--space-16) var(--space-20);
    border-radius: var(--radius-md);
    text-decoration: none;
    color: inherit;
    border: 1px solid var(--neutral-200);
    background: #fff;
    transition: border-color var(--transition-fast), box-shadow var(--transition-fast);
}

.recent-item:hover {
    border-color: var(--primary-purple);
    box-shadow: var(--shadow-sm);
    color: inherit;
    text-decoration: none;
}

.recent-meta {
    display: flex;
    gap: var(--space-12);
    font-size: var(--font-size-xs);
    color: var(--neutral-400);
    margin-bottom: var(--space-4);
}

.recent-category {
    color: var(--primary-purple);
    font-weight: 600;
}

.recent-time {
    color: var(--text-secondary);
}

.recent-item h4 {
    font-size: var(--font-size-sm);
    font-weight: 600;
    margin: 0 0 2px;
    color: var(--neutral-900);
}

.recent-item p {
    font-size: var(--font-size-sm);
    color: var(--neutral-500);
    margin: 0;
    line-height: 1.5;
}

/* ---------- Responsive ---------- */
@media (max-width: 992px) {
    .docs-toc {
        display: none;
    }

    .docs-container {
        padding: var(--space-24) var(--space-16);
    }

    .docs-header-inner {
        padding: var(--space-12) var(--space-16);
    }

    .docs-header-nav {
        padding: 0 var(--space-16) var(--space-8);
    }
}

@media (max-width: 767px) {
    .docs-container {
        padding: var(--space-16) var(--space-12);
    }

    .docs-hero {
        padding: var(--space-32) 0;
    }

    .docs-hero h1 {
        font-size: var(--font-size-2xl);
    }

    .docs-content h1 {
        font-size: var(--font-size-2xl);
    }

    .docs-content h2 {
        font-size: var(--font-size-xl);
    }

    .docs-header-inner {
        flex-direction: row;
        flex-wrap: wrap;
        gap: var(--space-8);
        align-items: center;
    }

    .docs-header-title {
        flex-grow: 1;
    }

    .docs-header-search {
        width: 100%;
        order: 3;
        padding: 0 var(--space-12) var(--space-8);
    }

    .docs-header-search .form-control {
        width: 100%;
    }

    .docs-nav-prev-next .row {
        gap: var(--space-12);
    }


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

/* ====== E21-S09: Responsive & Dark Mode ====== */

/* ---------- CSS Custom Properties (Light Theme Defaults) ---------- */
:root {
    --docs-bg-primary: #ffffff;
    --docs-bg-secondary: #fafafa;
    --docs-bg-card: #ffffff;
    --docs-bg-code: #1e1e2e;
    --docs-bg-inline-code: rgba(113, 97, 239, 0.08);
    --docs-bg-overlay: rgba(0, 0, 0, 0.5);
    --docs-bg-progress-bar: var(--primary-purple);
    --docs-text-primary: #212121;
    --docs-text-secondary: #616161;
    --docs-text-muted: #9e9e9e;
    --docs-text-code: var(--primary-purple);
    --docs-text-code-block: #cdd6f4;
    --docs-border-color: #eeeeee;
    --docs-border-focus: var(--primary-purple);
    --docs-input-bg: #fafafa;
    --docs-input-border: #eeeeee;
    --docs-scrolltop-bg: var(--primary-purple);
    --docs-scrolltop-color: #ffffff;
    --docs-sidebar-bg: #ffffff;
    --docs-blockquote-bg: rgba(113, 97, 239, 0.04);
    --docs-table-header-bg: #f5f5f5;
    --docs-table-hover-bg: #fafafa;
    --docs-badge-bg: rgba(113, 97, 239, 0.08);
    --docs-card-hover-shadow: var(--shadow-md);
}

/* ---------- Dark Theme Overrides ---------- */
[data-theme="dark"] {
    --docs-bg-primary: #0f1117;
    --docs-bg-secondary: #1a1d2e;
    --docs-bg-card: #1e2130;
    --docs-bg-code: #0a0c14;
    --docs-bg-inline-code: rgba(113, 97, 239, 0.15);
    --docs-bg-overlay: rgba(0, 0, 0, 0.7);
    --docs-text-primary: #e4e4e7;
    --docs-text-secondary: #a1a1aa;
    --docs-text-muted: #71717a;
    --docs-text-code: #b4a7f5;
    --docs-text-code-block: #cdd6f4;
    --docs-border-color: #2e3148;
    --docs-border-focus: var(--primary-purple);
    --docs-input-bg: #1a1d2e;
    --docs-input-border: #2e3148;
    --docs-scrolltop-bg: var(--primary-purple);
    --docs-scrolltop-color: #ffffff;
    --docs-sidebar-bg: #1a1d2e;
    --docs-blockquote-bg: rgba(113, 97, 239, 0.08);
    --docs-table-header-bg: #1a1d2e;
    --docs-table-hover-bg: #252840;
    --docs-badge-bg: rgba(113, 97, 239, 0.15);
    --docs-card-hover-shadow: 0 4px 6px rgba(0, 0, 0, 0.4);
}

/* ---------- Docs Dark Mode Toggle ---------- */
.docs-theme-toggle {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    width: 36px;
    height: 36px;
    border-radius: var(--radius-sm);
    border: 1px solid var(--neutral-300);
    background: transparent;
    color: var(--neutral-600);
    cursor: pointer;
    transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
    font-size: 1rem;
    padding: 0;
    flex-shrink: 0;
}

.docs-theme-toggle:hover {
    background: var(--neutral-100);
    color: var(--neutral-800);
    border-color: var(--neutral-400);
}

.docs-theme-toggle:focus-visible {
    outline: 2px solid var(--docs-border-focus);
    outline-offset: 2px;
}

[data-theme="dark"] .docs-theme-toggle {
    border-color: #3f4363;
    color: #a1a1aa;
}

[data-theme="dark"] .docs-theme-toggle:hover {
    background: #252840;
    color: #e4e4e7;
    border-color: #52567a;
}

/* ---------- Mobile Hamburger Button ---------- */
.docs-mobile-menu-btn {
    display: none;
    align-items: center;
    justify-content: center;
    width: 36px;
    height: 36px;
    border-radius: var(--radius-sm);
    border: 1px solid var(--neutral-300);
    background: transparent;
    color: var(--neutral-600);
    cursor: pointer;
    transition: background var(--transition-fast), color var(--transition-fast);
    font-size: 1rem;
    padding: 0;
    flex-shrink: 0;
}

.docs-mobile-menu-btn:hover {
    background: var(--neutral-100);
    color: var(--neutral-800);
}

.docs-mobile-menu-btn:focus-visible {
    outline: 2px solid var(--docs-border-focus);
    outline-offset: 2px;
}

[data-theme="dark"] .docs-mobile-menu-btn {
    border-color: #3f4363;
    color: #a1a1aa;
}

[data-theme="dark"] .docs-mobile-menu-btn:hover {
    background: #252840;
    color: #e4e4e7;
}

/* ---------- Reading Progress Bar ---------- */
.docs-reading-progress {
    position: fixed;
    top: 0;
    left: 0;
    width: 100%;
    height: 3px;
    z-index: 9999;
    background: transparent;
    pointer-events: none;
}

.docs-reading-progress-bar {
    height: 100%;
    width: 0%;
    background: var(--gradient-brand);
    transition: width 50ms linear;
    border-radius: 0 2px 2px 0;
}

/* ---------- Scroll-to-Top Button ---------- */
.docs-scroll-top {
    position: fixed;
    bottom: 2rem;
    right: 2rem;
    width: 44px;
    height: 44px;
    border-radius: 50%;
    border: none;
    background: var(--docs-scrolltop-bg);
    color: var(--docs-scrolltop-color);
    cursor: pointer;
    box-shadow: var(--shadow-lg);
    display: flex;
    align-items: center;
    justify-content: center;
    font-size: 1.1rem;
    z-index: 100;
    opacity: 0;
    visibility: hidden;
    transform: translateY(10px);
    transition: opacity var(--transition-base), visibility var(--transition-base), transform var(--transition-base), background var(--transition-fast);
}

.docs-scroll-top:hover {
    background: var(--primary-blue);
    transform: translateY(-2px);
    box-shadow: var(--shadow-xl);
}

.docs-scroll-top:focus-visible {
    outline: 2px solid var(--docs-border-focus);
    outline-offset: 2px;
}

.docs-scroll-top.visible {
    opacity: 1;
    visibility: visible;
    transform: translateY(0);
}

/* ---------- Skip-to-Content Link ---------- */
.docs-skip-link {
    position: absolute;
    top: -100%;
    left: 0;
    z-index: 10000;
    padding: var(--space-8) var(--space-16);
    background: var(--primary-purple);
    color: #fff;
    text-decoration: none;
    font-weight: 600;
    font-size: var(--font-size-sm);
    border-radius: 0 0 var(--radius-sm) 0;
    transition: top var(--transition-fast);
}

.docs-skip-link:focus {
    top: 0;
    color: #fff;
}

/* ---------- Mobile Sidebar Overlay ---------- */
.docs-mobile-overlay {
    position: fixed;
    inset: 0;
    background: var(--docs-bg-overlay);
    z-index: 999;
    opacity: 0;
    visibility: hidden;
    transition: opacity var(--transition-base), visibility var(--transition-base);
}

.docs-mobile-overlay.active {
    opacity: 1;
    visibility: visible;
}

/* ---------- Mobile Off-Canvas Sidebar ---------- */
.docs-mobile-sidebar {
    position: fixed;
    top: 0;
    left: 0;
    width: 300px;
    max-width: 85vw;
    height: 100%;
    background: var(--docs-sidebar-bg);
    z-index: 1000;
    transform: translateX(-100%);
    transition: transform var(--transition-base);
    overflow-y: auto;
    box-shadow: var(--shadow-xl);
    padding: var(--space-20);
}

.docs-mobile-sidebar.open {
    transform: translateX(0);
}

[data-theme="dark"] .docs-mobile-sidebar {
    background: #1a1d2e;
    box-shadow: 0 0 40px rgba(0, 0, 0, 0.6);
}

.docs-mobile-sidebar-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding-bottom: var(--space-16);
    margin-bottom: var(--space-16);
    border-bottom: 1px solid var(--docs-border-color);
}

.docs-mobile-sidebar-header h5 {
    margin: 0;
    font-size: var(--font-size-base);
    font-weight: 600;
    color: var(--docs-text-primary);
}

.docs-mobile-sidebar-close {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 32px;
    height: 32px;
    border-radius: var(--radius-sm);
    border: none;
    background: transparent;
    color: var(--neutral-500);
    cursor: pointer;
    font-size: 1.1rem;
    transition: background var(--transition-fast), color var(--transition-fast);
}

.docs-mobile-sidebar-close:hover {
    background: var(--neutral-100);
    color: var(--neutral-800);
}

[data-theme="dark"] .docs-mobile-sidebar-close:hover {
    background: #252840;
    color: #e4e4e7;
}

.docs-mobile-sidebar-nav {
    list-style: none;
    padding: 0;
    margin: 0;
}

.docs-mobile-sidebar-nav li {
    margin-bottom: var(--space-4);
}

.docs-mobile-sidebar-nav a {
    display: flex;
    align-items: center;
    gap: var(--space-12);
    padding: var(--space-12) var(--space-16);
    border-radius: var(--radius-md);
    font-size: var(--font-size-base);
    font-weight: 500;
    color: var(--neutral-600);
    text-decoration: none;
    transition: background var(--transition-fast), color var(--transition-fast);
}

.docs-mobile-sidebar-nav a:hover {
    background: var(--neutral-100);
    color: var(--neutral-900);
}

.docs-mobile-sidebar-nav a.active {
    background: rgba(113, 97, 239, 0.1);
    color: var(--primary-purple);
}

[data-theme="dark"] .docs-mobile-sidebar-nav a {
    color: #a1a1aa;
}

[data-theme="dark"] .docs-mobile-sidebar-nav a:hover {
    background: #252840;
    color: #e4e4e7;
}

[data-theme="dark"] .docs-mobile-sidebar-nav a.active {
    background: rgba(113, 97, 239, 0.2);
    color: var(--primary-purple);
}

.docs-mobile-sidebar-search {
    margin-bottom: var(--space-16);
}

.docs-mobile-sidebar-search .form-control {
    font-size: var(--font-size-sm);
    background: var(--docs-input-bg);
    border-color: var(--docs-input-border);
}

[data-theme="dark"] .docs-mobile-sidebar-search .form-control {
    background: #0f1117;
    border-color: #2e3148;
    color: #e4e4e7;
}

/* ---------- Article Content Wrapper (for progress tracking) ---------- */
#article-content {
    /* prose width cap */
    max-width: 720px;
}

#article-content > * {
    /* Ensure content flow */
}

/* ---------- Enhanced Typography ---------- */
.docs-article-content {
    font-size: 1rem;
    line-height: 1.75;
}

.docs-article-content h1 {
    font-size: 2.25rem;
    line-height: 1.2;
    margin-top: var(--space-40);
    margin-bottom: var(--space-16);
}

.docs-article-content h2 {
    font-size: 1.75rem;
    line-height: 1.3;
    margin-top: var(--space-40);
    margin-bottom: var(--space-12);
}

.docs-article-content h3 {
    font-size: 1.375rem;
    line-height: 1.4;
    margin-top: var(--space-32);
    margin-bottom: var(--space-12);
}

.docs-article-content h4 {
    font-size: 1.125rem;
    line-height: 1.4;
    margin-top: var(--space-24);
    margin-bottom: var(--space-8);
}

/* ---------- Focus Indicators (Keyboard Navigation) ---------- */
.docs-header-nav a:focus-visible,
.docs-toc a:focus-visible,
.docs-nav-link:focus-visible,
.docs-tag:focus-visible,
.docs-article-card:focus-visible,
.docs-category-browse:focus-visible,
.docs-search-result:focus-visible,
.docs-back-link:focus-visible,
.docs-view-all:focus-visible,
.audience-card:focus-visible,
.category-card:focus-visible,
.recent-item:focus-visible {
    outline: 2px solid var(--docs-border-focus);
    outline-offset: 2px;
}

/* ---------- TOC inline mode (medium screens) ---------- */
.docs-toc-inline {
    display: none;
    background: var(--docs-bg-card);
    border: 1px solid var(--docs-border-color);
    border-radius: var(--radius-md);
    padding: var(--space-16) var(--space-20);
    margin-bottom: var(--space-24);
}

[data-theme="dark"] .docs-toc-inline {
    background: #1e2130;
    border-color: #2e3148;
}

.docs-toc-inline h6 {
    font-size: var(--font-size-xs);
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--neutral-500);
    margin-bottom: var(--space-8);
}

.docs-toc-inline ul {
    list-style: none;
    padding: 0;
    margin: 0;
    columns: 2;
    column-gap: var(--space-16);
}

.docs-toc-inline li {
    margin-bottom: var(--space-4);
    break-inside: avoid;
}

.docs-toc-inline li.toc-h3 {
    padding-left: var(--space-12);
}

.docs-toc-inline a {
    font-size: var(--font-size-sm);
    color: var(--neutral-600);
    text-decoration: none;
    transition: color var(--transition-fast);
}

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

/* ---------- Responsive: >= 1280px Three Columns ---------- */
@media (min-width: 1280px) {
    .docs-container {
        max-width: 1320px;
    }

    .docs-toc {
        display: block;
    }

    .docs-toc-inline {
        display: none;
    }
}

/* ---------- Responsive: 768-1279px Two Columns ---------- */
@media (min-width: 768px) and (max-width: 1279px) {
    .docs-toc {
        display: none;
    }

    .docs-toc-inline {
        display: block;
    }

    .docs-container {
        gap: var(--space-24);
    }

    .docs-mobile-menu-btn {
        display: none;
    }
}

/* ---------- Responsive: < 768px Single Column / Mobile ---------- */
@media (max-width: 767px) {
    .docs-mobile-menu-btn {
        display: flex;
    }

    .docs-toc {
        display: none;
    }

    .docs-toc-inline {
        display: block;
    }

    .docs-toc-inline ul {
        columns: 1;
    }

    .docs-header-inner {
        flex-direction: row;
        flex-wrap: wrap;
        gap: var(--space-8);
        padding: var(--space-8) var(--space-12);
    }

    .docs-header-search {
        width: 100%;
        order: 3;
    }

    .docs-header-search .form-control {
        width: 100%;
    }

    .docs-header-nav {
        padding: 0 var(--space-12) var(--space-8);
        display: none;
    }

    .docs-header-nav.mobile-visible {
        display: flex;
    }

    .docs-container {
        flex-direction: column;
        padding: var(--space-12) var(--space-12);
    }

    .docs-content-narrow {
        max-width: 100%;
    }

    #article-content {
        max-width: 100%;
    }

    .docs-hero {
        padding: var(--space-24) 0;
    }

    .docs-hero h1 {
        font-size: var(--font-size-2xl);
    }

    .docs-article-content h1 {
        font-size: 1.75rem;
    }

    .docs-article-content h2 {
        font-size: 1.375rem;
    }

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

    .docs-article-content h4 {
        font-size: 1rem;
    }

    .docs-nav-prev-next .col-6 {
        flex: 0 0 100%;
        max-width: 100%;
    }

    .docs-nav-prev-next .row {
        gap: var(--space-8);
    }

    .docs-scroll-top {
        bottom: 1.5rem;
        right: 1.5rem;
        width: 40px;
        height: 40px;
        font-size: 1rem;
    }

    .docs-article-meta {
        flex-direction: column;
        align-items: flex-start;
        gap: var(--space-8);
    }

    .audience-cards {
        grid-template-columns: 1fr;
    }

    .category-grid {
        grid-template-columns: 1fr 1fr;
    }
}

@media (max-width: 480px) {
    .docs-header-title {
        font-size: var(--font-size-base);
    }

    .docs-container {
        padding: var(--space-8);
    }

    .docs-article-content {
        font-size: 0.9375rem;
    }
}

/* ---------- prefers-reduced-motion ---------- */
@media (prefers-reduced-motion: reduce) {
    .docs-scroll-top,
    .docs-mobile-sidebar,
    .docs-mobile-overlay,
    .docs-reading-progress-bar,
    .docs-article-card,
    .docs-stat-card,
    .docs-category-card,
    .audience-card,
    .category-card,
    .recent-item,
    .docs-theme-toggle,
    .docs-mobile-menu-btn {
        transition: none !important;
        animation: none !important;
    }

    .docs-scroll-top.visible {
        transform: none;
    }

    .docs-mobile-sidebar.open {
        transform: none;
    }
}

/* ---------- Print Styles ---------- */
@media print {
    .docs-header,
    .docs-header-nav,
    .docs-toc,
    .docs-toc-inline,
    .docs-mobile-sidebar,
    .docs-mobile-overlay,
    .docs-mobile-menu-btn,
    .docs-theme-toggle,
    .docs-scroll-top,
    .docs-reading-progress,
    .docs-skip-link,
    .docs-feedback,
    .docs-nav-prev-next,
    .docs-hero-search,
    .navbar,
    .navbar-public,
    .footer-public,
    footer {
        display: none !important;
    }

    .docs-page {
        background: #fff !important;
    }

    .docs-container {
        display: block;
        max-width: 100%;
        padding: 0;
    }

    .docs-content {
        max-width: 100%;
    }

    .docs-content-narrow {
        max-width: 100%;
    }

    .docs-article-content {
        font-size: 12pt;
        line-height: 1.6;
        color: #000;
    }

    .docs-article-content h1 { font-size: 20pt; }
    .docs-article-content h2 { font-size: 16pt; }
    .docs-article-content h3 { font-size: 14pt; }
    .docs-article-content h4 { font-size: 12pt; }

    .docs-content pre {
        background: #f5f5f5 !important;
        color: #333 !important;
        border: 1px solid #ddd;
        box-shadow: none;
        page-break-inside: avoid;
    }

    .docs-content table {
        page-break-inside: avoid;
    }

    .docs-article-card {
        box-shadow: none !important;
        border: 1px solid #ddd;
        page-break-inside: avoid;
    }

    a[href]::after {
        content: " (" attr(href) ")";
        font-size: 0.8em;
        color: #666;
    }

    .docs-breadcrumb a[href]::after,
    .docs-header-nav a[href]::after {
        content: none;
    }
}

/* ==========================================================================
   Search Type-Ahead & Full-Text Search Styles (E21-S06)
   ========================================================================== */

/* ---------- Autocomplete dropdown ---------- */
.docs-search-input-wrapper {
    position: relative;
}

.docs-search-dropdown {
    display: none;
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    z-index: calc(var(--z-sticky, 1020) + 10);
    background: var(--docs-bg-card, #fff);
    border: 1px solid var(--docs-border-color, var(--neutral-200));
    border-top: none;
    border-radius: 0 0 var(--radius-md) var(--radius-md);
    box-shadow: var(--shadow-lg);
    max-height: 400px;
    overflow-y: auto;
}

.docs-search-dropdown.open {
    display: block;
}

.docs-search-dropdown-item {
    display: flex;
    align-items: center;
    gap: var(--space-12);
    padding: var(--space-12) var(--space-16);
    cursor: pointer;
    transition: background var(--transition-fast);
    text-decoration: none;
    color: var(--docs-text-secondary, var(--neutral-700));
    border-bottom: 1px solid var(--docs-border-color, var(--neutral-100));
}

.docs-search-dropdown-item:last-child {
    border-bottom: none;
}

.docs-search-dropdown-item:hover,
.docs-search-dropdown-item.active {
    background: var(--docs-bg-secondary, var(--neutral-50));
}

.docs-search-dropdown-icon {
    flex-shrink: 0;
    width: 16px;
    text-align: center;
    color: var(--docs-text-muted, var(--neutral-400));
    font-size: var(--font-size-sm);
}

.docs-search-dropdown-text {
    display: flex;
    flex-direction: column;
    min-width: 0;
}

.docs-search-dropdown-title {
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--docs-text-primary, var(--neutral-800));
    white-space: nowrap;
    overflow: hidden;
    text-overflow: ellipsis;
}

.docs-search-dropdown-category {
    font-size: var(--font-size-xs);
    color: var(--docs-text-muted, var(--neutral-500));
    margin-top: 2px;
}

.docs-search-dropdown-title mark,
.docs-search-dropdown-category mark {
    background: rgba(113, 97, 239, 0.15);
    color: var(--primary-purple);
    padding: 0 1px;
    border-radius: 2px;
}

/* ---------- Highlighted search terms in results ---------- */
.search-result-title mark,
.search-result-excerpt mark {
    background: rgba(255, 213, 79, 0.4);
    color: inherit;
    padding: 1px 2px;
    border-radius: 2px;
    font-weight: 600;
}

[data-theme="dark"] .search-result-title mark,
[data-theme="dark"] .search-result-excerpt mark {
    background: rgba(255, 213, 79, 0.25);
}

[data-theme="dark"] .docs-search-dropdown-title mark,
[data-theme="dark"] .docs-search-dropdown-category mark {
    background: rgba(113, 97, 239, 0.3);
}

/* ---------- Pagination ---------- */
.docs-pagination {
    margin-top: var(--space-24);
    display: flex;
    justify-content: center;
}

.docs-pagination-list {
    display: flex;
    align-items: center;
    gap: var(--space-4);
    list-style: none;
    padding: 0;
    margin: 0;
}

.docs-pagination-link {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 36px;
    height: 36px;
    padding: 0 var(--space-8);
    border: 1px solid var(--docs-border-color, var(--neutral-200));
    border-radius: var(--radius-sm);
    font-size: var(--font-size-sm);
    font-weight: 500;
    color: var(--docs-text-secondary, var(--neutral-700));
    text-decoration: none;
    background: var(--docs-bg-card, #fff);
    transition: border-color var(--transition-fast), color var(--transition-fast), background var(--transition-fast);
}

.docs-pagination-link:hover {
    border-color: var(--primary-purple);
    color: var(--primary-purple);
    background: rgba(113, 97, 239, 0.04);
    text-decoration: none;
}

.docs-pagination-active {
    background: var(--primary-purple);
    border-color: var(--primary-purple);
    color: #fff;
}

.docs-pagination-active:hover {
    background: var(--primary-purple);
    border-color: var(--primary-purple);
    color: #fff;
    opacity: 0.9;
}

.docs-pagination-ellipsis {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 36px;
    height: 36px;
    font-size: var(--font-size-sm);
    color: var(--docs-text-muted, var(--neutral-400));
}

/* ---------- Header search dropdown positioning ---------- */
.docs-header-search {
    position: relative;
}

.docs-header-search .docs-search-dropdown {
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    border-top: 1px solid var(--docs-border-color, var(--neutral-200));
    border-radius: 0 0 var(--radius-md) var(--radius-md);
    min-width: 320px;
}

/* ---------- Hero search dropdown positioning ---------- */
.docs-hero-search {
    position: relative;
}

.docs-hero-search .docs-search-dropdown {
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    border-radius: 0 0 var(--radius-md) var(--radius-md);
    text-align: left;
}

/* ---------- Search page search box dropdown positioning ---------- */
.docs-search-box {
    position: relative;
}

.docs-search-box .docs-search-dropdown {
    left: var(--space-24);
    right: var(--space-24);
}

/* ---------- Responsive adjustments for search ---------- */
@media (max-width: 768px) {
    .docs-header-search .docs-search-dropdown {
        min-width: 100%;
    }

    .docs-search-box .docs-search-dropdown {
        left: var(--space-12);
        right: var(--space-12);
    }

    .docs-pagination-link {
        min-width: 32px;
        height: 32px;
        font-size: var(--font-size-xs);
    }
}

/* ==========================================================================
   Code Examples & Language Tabs (E21-S07)
   ========================================================================== */

/* ---------- Standalone Code Block Wrapper ---------- */
.code-block-wrapper {
    position: relative;
    margin: var(--space-24) 0;
    border-radius: var(--radius-md);
    overflow: hidden;
    background: #1e1e2e;
    box-shadow: var(--shadow-md);
}

.code-block-wrapper pre {
    margin: 0;
    border-radius: 0;
    box-shadow: none;
}

/* ---------- Code Block Header (language label + copy btn) ---------- */
.code-block-header {
    display: flex;
    align-items: center;
    justify-content: space-between;
    padding: var(--space-8) var(--space-16);
    background: #181825;
    border-bottom: 1px solid #313244;
    font-size: var(--font-size-xs);
}

.code-lang-label {
    color: #a6adc8;
    font-weight: 600;
    font-family: 'SF Mono', 'Fira Code', 'Courier New', monospace;
    font-size: 0.75rem;
    text-transform: uppercase;
    letter-spacing: 0.04em;
}

/* ---------- Copy Button ---------- */
.code-copy-btn {
    display: inline-flex;
    align-items: center;
    gap: 4px;
    padding: 4px 10px;
    border: 1px solid #45475a;
    border-radius: var(--radius-sm);
    background: transparent;
    color: #a6adc8;
    font-size: 0.75rem;
    font-family: inherit;
    cursor: pointer;
    transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
    white-space: nowrap;
}

.code-copy-btn:hover {
    background: #313244;
    color: #cdd6f4;
    border-color: #585b70;
}

.code-copy-btn:focus-visible {
    outline: 2px solid var(--primary-purple);
    outline-offset: 2px;
}

.code-copy-btn.copied {
    color: #a6e3a1;
    border-color: #a6e3a1;
}

/* Copy button inside code-group panels (positioned absolutely) */
.code-panel .code-copy-btn {
    position: absolute;
    top: var(--space-8);
    right: var(--space-12);
    z-index: 2;
    opacity: 0;
    transition: opacity var(--transition-fast), background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
}

.code-panel .code-block-wrapper {
    position: relative;
    margin: 0;
    box-shadow: none;
    border-radius: 0;
}

.code-panel .code-block-wrapper:hover .code-copy-btn,
.code-panel .code-copy-btn:focus-visible {
    opacity: 1;
}

/* ---------- Code Group (Tabbed) ---------- */
.code-group {
    margin: var(--space-24) 0;
    border-radius: var(--radius-md);
    overflow: hidden;
    background: #1e1e2e;
    box-shadow: var(--shadow-md);
}

/* Tab bar */
.code-group-tabs {
    display: flex;
    background: #181825;
    border-bottom: 1px solid #313244;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
    scrollbar-width: none;
}

.code-group-tabs::-webkit-scrollbar {
    display: none;
}

/* Individual tab */
.code-tab {
    position: relative;
    display: inline-flex;
    align-items: center;
    padding: var(--space-8) var(--space-16);
    border: none;
    background: transparent;
    color: #6c7086;
    font-size: var(--font-size-sm);
    font-weight: 500;
    font-family: inherit;
    cursor: pointer;
    white-space: nowrap;
    transition: color var(--transition-fast), background var(--transition-fast);
}

.code-tab:hover {
    color: #bac2de;
    background: rgba(205, 214, 244, 0.05);
}

.code-tab:focus-visible {
    outline: 2px solid var(--primary-purple);
    outline-offset: -2px;
}

.code-tab.active {
    color: #cdd6f4;
}

/* Active tab underline indicator */
.code-tab.active::after {
    content: '';
    position: absolute;
    bottom: 0;
    left: var(--space-16);
    right: var(--space-16);
    height: 2px;
    background: var(--primary-purple);
    border-radius: 2px 2px 0 0;
}

/* Panels container */
.code-group-panels {
    position: relative;
}

/* Individual panel */
.code-panel {
    display: none;
}

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

.code-panel pre {
    margin: 0;
    border-radius: 0;
    box-shadow: none;
    background: #1e1e2e;
}

/* ---------- Dark Mode Adjustments ---------- */
[data-theme="dark"] .code-block-wrapper {
    background: #0a0c14;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.4);
}

[data-theme="dark"] .code-block-header {
    background: #070810;
    border-bottom-color: #1a1d2e;
}

[data-theme="dark"] .code-lang-label {
    color: #71717a;
}

[data-theme="dark"] .code-copy-btn {
    border-color: #2e3148;
    color: #71717a;
}

[data-theme="dark"] .code-copy-btn:hover {
    background: #1a1d2e;
    color: #a1a1aa;
    border-color: #3f4363;
}

[data-theme="dark"] .code-group {
    background: #0a0c14;
    box-shadow: 0 4px 6px rgba(0, 0, 0, 0.4);
}

[data-theme="dark"] .code-group-tabs {
    background: #070810;
    border-bottom-color: #1a1d2e;
}

[data-theme="dark"] .code-tab {
    color: #52567a;
}

[data-theme="dark"] .code-tab:hover {
    color: #a1a1aa;
    background: rgba(255, 255, 255, 0.03);
}

[data-theme="dark"] .code-tab.active {
    color: #e4e4e7;
}

[data-theme="dark"] .code-panel pre {
    background: #0a0c14;
}

/* ---------- Responsive: Code blocks ---------- */
@media (max-width: 767px) {
    .code-block-wrapper {
        margin: var(--space-16) calc(-1 * var(--space-12));
        border-radius: 0;
    }

    .code-group {
        margin: var(--space-16) calc(-1 * var(--space-12));
        border-radius: 0;
    }

    .code-block-wrapper pre,
    .code-panel pre {
        font-size: 0.8rem;
        padding: var(--space-12);
    }

    .code-tab {
        padding: var(--space-8) var(--space-12);
        font-size: var(--font-size-xs);
    }

    .code-block-header {
        padding: var(--space-4) var(--space-12);
    }
}

/* ---------- Print: Code blocks ---------- */
@media print {
    .code-copy-btn {
        display: none !important;
    }

    .code-group-tabs {
        background: #eee !important;
        border-bottom: 1px solid #ddd !important;
    }

    .code-tab {
        color: #333 !important;
    }

    .code-tab.active::after {
        background: #333 !important;
    }

    .code-block-wrapper,
    .code-group {
        box-shadow: none !important;
        border: 1px solid #ddd !important;
    }

    .code-block-header {
        background: #eee !important;
        border-bottom: 1px solid #ddd !important;
    }

    .code-lang-label {
        color: #555 !important;
    }

    /* Show all panels in print */
    .code-panel {
        display: block !important;
        border-top: 1px solid #ddd;
    }
}

/* ---------- Reduced Motion ---------- */
@media (prefers-reduced-motion: reduce) {
    .code-copy-btn,
    .code-tab {
        transition: none !important;
    }

    .code-panel .code-copy-btn {
        opacity: 1;
    }
}