/* ===================================
   DOCUMENTATION FEATURE DETAIL PAGE STYLES
   File: src/Modules/Documentation/Presentation/Templates/css/documentation-page.css
   Description: Professional styles for documentation feature pages with sidebar navigation.
   Clean, minimal design inspired by Bootstrap documentation. Consistent with home sections.
   Uses only common CSS variables.
   
   DESIGN APPROACH:
   - Clean, professional documentation style (no gradient backgrounds)
   - Minimal, readable layout
   - Consistent with existing design system
   - Focus on content readability
   
   NOTE: This file uses --header-height CSS variable (default: 70px) to position the sidebar
   below the fixed header. If your header height is different, define --header-height in common.css:
   :root { --header-height: 80px; }
   
   Z-INDEX LAYERING:
   - Header: var(--z-index-sticky) [highest]
   - Footer: var(--z-index-sticky) - 5
   - Toggle: var(--z-index-sticky) - 9
   - Sidebar: var(--z-index-sticky) - 10
   - Overlay: var(--z-index-sticky) - 11 [lowest]
   =================================== */

/* ===================================
   FEATURE LAYOUT - MAIN CONTAINER
   =================================== */

.docs-feature {
    display: flex;
    min-height: 100vh;
    background: var(--color-background);
}

/* ===================================
   SIDEBAR - NAVIGATION
   =================================== */

.docs-feature__sidebar {
    width: 280px;
    background: var(--color-surface);
    border-right: var(--border-width-1) solid var(--color-border);
    position: fixed;
    top: var(--header-height, 70px);
    left: 0;
    height: calc(100vh - var(--header-height, 70px));
    overflow-y: auto;
    z-index: calc(var(--z-index-sticky) - 10);
    transition: var(--transition-base);
}

/* Ensure footer appears above sidebar when scrolled */
.footer,
.site-footer,
[class*="footer"] {
    position: relative;
    z-index: calc(var(--z-index-sticky) - 5);
}

/* Sidebar Scrollbar Styling */
.docs-feature__sidebar::-webkit-scrollbar {
    width: 6px;
}

.docs-feature__sidebar::-webkit-scrollbar-track {
    background: var(--color-background-secondary);
}

.docs-feature__sidebar::-webkit-scrollbar-thumb {
    background: var(--color-primary-300);
    border-radius: var(--border-radius-full);
}

.docs-feature__sidebar::-webkit-scrollbar-thumb:hover {
    background: var(--color-primary-500);
}

/* ===================================
   SIDEBAR CONTENT
   =================================== */

.docs-sidebar {
    display: flex;
    flex-direction: column;
    height: 100%;
    padding: var(--spacing-6) 0;
}

/* Sidebar Header */
.docs-sidebar__header {
    padding: 0 var(--spacing-6) var(--spacing-4);
    border-bottom: var(--border-width-1) solid var(--color-border);
    margin-bottom: var(--spacing-4);
}

.docs-sidebar__close {
    display: none;
    background: transparent;
    border: none;
    font-size: var(--font-size-xl);
    color: var(--color-text-muted);
    cursor: pointer;
    padding: var(--spacing-2);
    margin-bottom: var(--spacing-3);
    transition: var(--transition-color);
}

.docs-sidebar__close:hover {
    color: var(--color-primary-500);
}

.docs-sidebar__back {
    display: inline-flex;
    align-items: center;
    gap: var(--spacing-2);
    font-size: var(--font-size-sm);
    font-weight: var(--font-weight-medium);
    color: var(--color-text-secondary);
    text-decoration: none;
    transition: var(--transition-color);
}

.docs-sidebar__back:hover {
    color: var(--color-primary-500);
}

.docs-sidebar__back i {
    font-size: var(--font-size-xs);
}

/* Sidebar Title */
.docs-sidebar__title {
    display: flex;
    align-items: center;
    gap: var(--spacing-3);
    padding: 0 var(--spacing-6) var(--spacing-4);
    border-bottom: var(--border-width-1) solid var(--color-border);
    margin-bottom: var(--spacing-4);
}

.docs-sidebar__icon {
    font-size: var(--font-size-2xl);
    color: var(--color-primary-500);
}

.docs-sidebar__heading {
    font-size: var(--font-size-xl);
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-text-primary);
    margin: 0;
    line-height: var(--line-height-tight);
}

/* ===================================
   SIDEBAR NAVIGATION
   =================================== */

.docs-sidebar__nav {
    flex: 1;
    padding: 0 var(--spacing-4);
}

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

.docs-nav__item {
    margin-bottom: var(--spacing-1);
}

.docs-nav__link {
    display: flex;
    align-items: center;
    gap: var(--spacing-3);
    padding: var(--spacing-3) var(--spacing-4);
    font-size: var(--font-size-base);
    font-weight: var(--font-weight-medium);
    color: var(--color-text-secondary);
    text-decoration: none;
    border-radius: var(--border-radius-lg);
    transition: var(--transition-base);
    position: relative;
}

.docs-nav__link:hover {
    background: var(--color-background-hover);
    color: var(--color-primary-500);
    transform: translateX(4px);
}

.docs-nav__link i {
    font-size: var(--font-size-base);
    width: 20px;
    text-align: center;
}

/* Active Link */
.docs-nav__link--active {
    background: var(--color-primary-50);
    color: var(--color-primary-600);
    font-weight: var(--font-weight-semibold);
}

.docs-nav__link--active::before {
    content: '';
    position: absolute;
    left: 0;
    top: 50%;
    transform: translateY(-50%);
    width: 3px;
    height: 70%;
    background: var(--color-primary-500);
    border-radius: 0 var(--border-radius-base) var(--border-radius-base) 0;
}

/* ===================================
   SIDEBAR FOOTER
   =================================== */

.docs-sidebar__footer {
    padding: var(--spacing-4) var(--spacing-6);
    border-top: var(--border-width-1) solid var(--color-border);
    margin-top: auto;
}

.docs-sidebar__help {
    display: flex;
    flex-direction: column;
    gap: var(--spacing-2);
    padding: var(--spacing-4);
    background: var(--color-background-secondary);
    border-radius: var(--border-radius-lg);
    text-align: center;
}

.docs-sidebar__help i {
    font-size: var(--font-size-2xl);
    color: var(--color-primary-500);
}

.docs-sidebar__help span {
    font-size: var(--font-size-sm);
    color: var(--color-text-secondary);
    font-weight: var(--font-weight-medium);
}

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

.docs-sidebar__help-link:hover {
    color: var(--color-primary-600);
    text-decoration: underline;
}

/* ===================================
   MAIN CONTENT AREA
   =================================== */

.docs-feature__main {
    flex: 1;
    margin-left: 280px;
    min-height: 100vh;
}

/* ===================================
   FEATURE HERO - DOCUMENTATION STYLE
   =================================== */

.docs-hero--feature {
    background: var(--color-surface);
    padding: var(--spacing-8) 0 var(--spacing-10);
    position: relative;
    border-bottom: var(--border-width-1) solid var(--color-border);
}

/* Remove decorative background for clean professional look */
.docs-hero--feature::before {
    display: none;
}

.docs-hero--feature .docs-hero__content {
    position: relative;
    z-index: 1;
}

.docs-hero--feature .docs-hero__header {
    display: flex;
    gap: var(--spacing-4);
    margin-bottom: var(--spacing-4);
}

.docs-hero--feature .docs-hero__icon-wrapper {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 64px;
    height: 64px;
    border-radius: var(--border-radius-xl);
    background: var(--color-primary-50);
    border: var(--border-width-1) solid var(--color-primary-100);
    flex-shrink: 0;
}

.docs-hero--feature .docs-hero__icon {
    font-size: var(--font-size-3xl);
    color: var(--color-primary-500);
}

.docs-hero--feature .docs-hero__icon--primary {
    color: var(--color-primary-500);
}

.docs-hero--feature .docs-hero__text {
    flex: 1;
}

.docs-hero--feature .docs-hero__title {
    font-size: clamp(1.75rem, 4vw, var(--font-size-4xl));
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-text-primary);
    margin-bottom: var(--spacing-2);
    line-height: var(--line-height-tight);
}

.docs-hero--feature .docs-hero__subtitle {
    font-size: clamp(0.95rem, 2vw, var(--font-size-base));
    color: var(--color-text-secondary);
    line-height: var(--line-height-relaxed);
    margin: 0;
    max-width: 800px;
}

/* Quick Stats */
.docs-hero__stats {
    display: flex;
    gap: var(--spacing-3);
    flex-wrap: wrap;
    margin-top: var(--spacing-5);
}

.stat-badge {
    display: inline-flex;
    align-items: center;
    gap: var(--spacing-2);
    padding: var(--spacing-2) var(--spacing-3);
    background: var(--color-background-secondary);
    border: var(--border-width-1) solid var(--color-border);
    border-radius: var(--border-radius-base);
    font-size: var(--font-size-xs);
    font-weight: var(--font-weight-medium);
    color: var(--color-text-secondary);
}

.stat-badge i {
    font-size: var(--font-size-sm);
    color: var(--color-primary-500);
}

/* ===================================
   BREADCRUMB NAVIGATION
   =================================== */

.breadcrumb {
    margin-bottom: var(--spacing-6);
}

.breadcrumb__list {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    list-style: none;
    margin: 0;
    padding: 0;
    gap: var(--spacing-1);
}

.breadcrumb__item {
    display: inline-flex;
    align-items: center;
    font-size: var(--font-size-sm);
    color: var(--color-text-muted);
    line-height: var(--line-height-none);
    margin-bottom: 0 !important;  /* Override base.css li:last-child */
}

.breadcrumb__item:not(:last-child)::after {
    content: '/';
    margin: 0 var(--spacing-2);
    color: var(--color-text-muted);
    opacity: 0.5;
}

.breadcrumb__link {
    color: var(--color-primary-500);
    text-decoration: none;
    transition: var(--transition-color);
    line-height: var(--line-height-none);
    display: inline-block;
}

.breadcrumb__link:hover {
    color: var(--color-primary-600);
    text-decoration: underline;
}

.breadcrumb__item--active {
    color: var(--color-text-secondary);
    font-weight: var(--font-weight-medium);
    line-height: var(--line-height-none);
}

/* ===================================
   CONTENT SECTIONS
   =================================== */

.docs-content {
    background: var(--color-background);
    padding: var(--section-padding);
}

/* Content Block */
.content-block {
    margin-bottom: var(--spacing-10);
}

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

.content-block__title {
    font-size: clamp(1.5rem, 3vw, var(--font-size-3xl));
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-primary-500);
    margin-bottom: var(--spacing-4);
    line-height: var(--line-height-tight);
    position: relative;
    display: inline-block;
    padding-bottom: var(--spacing-3);
}

.content-block__text {
    font-size: var(--font-size-base);
    line-height: var(--line-height-relaxed);
    color: var(--color-text-secondary);
    margin-bottom: var(--spacing-4);
}

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

/* ===================================
   FEATURE GRID
   =================================== */

.feature-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(250px, 1fr));
    gap: var(--spacing-6);
    margin-top: var(--spacing-6);
}

.feature-item {
    padding: var(--spacing-6);
    background: var(--color-surface);
    border-radius: var(--radius-card);
    border: var(--border-width-1) solid rgba(59, 130, 246, 0.1);
    box-shadow: var(--shadow-sm);
    transition: var(--transition-base);
}

.feature-item:hover {
    box-shadow: var(--shadow-card-hover);
    transform: translateY(-4px);
    border-color: var(--color-primary-300);
}

.feature-item__icon-wrapper {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 56px;
    height: 56px;
    border-radius: var(--border-radius-full);
    background: var(--color-primary-50);
    margin-bottom: var(--spacing-4);
}

.feature-item__icon {
    font-size: var(--font-size-2xl);
    color: var(--color-primary-500);
    transition: var(--transition-transform);
}

.feature-item:hover .feature-item__icon {
    transform: scale(1.1);
}

.feature-item__title {
    font-size: var(--font-size-xl);
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-text-primary);
    margin-bottom: var(--spacing-2);
    line-height: var(--line-height-tight);
}

.feature-item__text {
    font-size: var(--font-size-sm);
    line-height: var(--line-height-relaxed);
    color: var(--color-text-secondary);
    margin: 0;
}

/* ===================================
   STEP CARDS
   =================================== */

.step-card {
    display: flex;
    gap: var(--spacing-6);
    padding: var(--spacing-8);
    background: var(--color-surface);
    border-radius: var(--radius-card);
    border: var(--border-width-1) solid rgba(59, 130, 246, 0.1);
    box-shadow: var(--shadow-card);
    margin-bottom: var(--spacing-6);
    transition: var(--transition-base);
    position: relative;
    overflow: hidden;
}

/* Accent bar on left */
.step-card::before {
    content: '';
    position: absolute;
    left: 0;
    top: 0;
    bottom: 0;
    width: 4px;
    background: var(--gradient-primary);
    opacity: 0;
    transition: var(--transition-base);
}

.step-card:hover {
    box-shadow: var(--shadow-card-hover);
    transform: translateY(-4px);
    border-color: var(--color-primary-300);
}

.step-card:hover::before {
    opacity: 1;
}

.step-card:last-child {
    margin-bottom: 0;
}

.step-card__number {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 64px;
    height: 64px;
    border-radius: var(--border-radius-full);
    background: var(--gradient-primary);
    color: var(--color-text-inverse);
    font-size: var(--font-size-3xl);
    font-weight: var(--font-weight-bold);
    flex-shrink: 0;
    box-shadow: var(--shadow-md);
}

.step-card__content {
    flex: 1;
}

.step-card__title {
    font-size: var(--font-size-2xl);
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-text-primary);
    margin-bottom: var(--spacing-3);
    line-height: var(--line-height-tight);
    display: flex;
    align-items: center;
    gap: var(--spacing-3);
}

.step-card__title i {
    font-size: var(--font-size-xl);
    color: var(--color-primary-500);
}

.step-card__text {
    font-size: var(--font-size-base);
    line-height: var(--line-height-relaxed);
    color: var(--color-text-secondary);
    margin-bottom: var(--spacing-4);
}

.step-card__link {
    display: inline-flex;
    align-items: center;
    gap: var(--spacing-2);
    font-size: var(--font-size-base);
    font-weight: var(--font-weight-semibold);
    color: var(--color-primary-500);
    text-decoration: none;
    transition: var(--transition-base);
}

.step-card__link:hover {
    color: var(--color-primary-600);
    gap: var(--spacing-3);
}

.step-card__link i {
    font-size: var(--font-size-sm);
    transition: var(--transition-transform);
}

.step-card__link:hover i {
    transform: translateX(4px);
}

/* ===================================
   NEXT STEPS GRID
   =================================== */

.next-steps-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: var(--spacing-6);
    margin-top: var(--spacing-6);
}

.next-step-card {
    display: flex;
    flex-direction: column;
    padding: var(--spacing-6);
    background: var(--color-surface);
    border-radius: var(--radius-card);
    border: var(--border-width-1) solid rgba(59, 130, 246, 0.1);
    box-shadow: var(--shadow-card);
    text-decoration: none;
    transition: var(--transition-base);
    position: relative;
    overflow: hidden;
}

.next-step-card::before {
    content: '';
    position: absolute;
    top: 0;
    left: 0;
    right: 0;
    height: 3px;
    background: var(--gradient-primary);
    opacity: 0;
    transition: var(--transition-base);
}

.next-step-card:hover {
    box-shadow: var(--shadow-card-hover);
    transform: translateY(-8px);
    border-color: var(--color-primary-300);
}

.next-step-card:hover::before {
    opacity: 1;
}

.next-step-card__icon {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 56px;
    height: 56px;
    border-radius: var(--border-radius-full);
    background: var(--color-primary-50);
    margin-bottom: var(--spacing-4);
}

.next-step-card__icon i {
    font-size: var(--font-size-2xl);
    color: var(--color-primary-500);
    transition: var(--transition-transform);
}

.next-step-card:hover .next-step-card__icon i {
    transform: scale(1.15) rotate(5deg);
}

.next-step-card__title {
    font-size: var(--font-size-xl);
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-text-primary);
    margin-bottom: var(--spacing-2);
    line-height: var(--line-height-tight);
}

.next-step-card__text {
    font-size: var(--font-size-sm);
    line-height: var(--line-height-relaxed);
    color: var(--color-text-secondary);
    margin-bottom: var(--spacing-4);
    flex: 1;
}

.next-step-card__arrow {
    display: flex;
    align-items: center;
    justify-content: flex-end;
    color: var(--color-primary-500);
    font-size: var(--font-size-lg);
    transition: var(--transition-transform);
}

.next-step-card:hover .next-step-card__arrow {
    transform: translateX(4px);
}

/* ===================================
   HELP CARD
   =================================== */

.help-card {
    display: flex;
    gap: var(--spacing-4);
    padding: var(--spacing-6);
    background: var(--color-primary-50);
    border-radius: var(--radius-card);
    border: var(--border-width-1) solid var(--color-primary-200);
}

.help-card__icon {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 48px;
    height: 48px;
    border-radius: var(--border-radius-full);
    background: var(--color-primary-500);
    color: var(--color-text-inverse);
    font-size: var(--font-size-2xl);
    flex-shrink: 0;
}

.help-card__content {
    flex: 1;
}

.help-card__title {
    font-size: var(--font-size-xl);
    font-family: var(--font-family-heading);
    font-weight: var(--font-weight-bold);
    color: var(--color-primary-700);
    margin-bottom: var(--spacing-2);
    line-height: var(--line-height-tight);
}

.help-card__text {
    font-size: var(--font-size-base);
    line-height: var(--line-height-relaxed);
    color: var(--color-primary-800);
    margin: 0;
}

.help-card__link {
    color: var(--color-primary-600);
    font-weight: var(--font-weight-semibold);
    text-decoration: none;
    transition: var(--transition-color);
}

.help-card__link:hover {
    color: var(--color-primary-700);
    text-decoration: underline;
}

/* ===================================
   ALERTS (From common.css, extended)
   =================================== */

.alert__list {
    list-style: none;
    margin: var(--spacing-3) 0 0;
    padding: 0;
}

.alert__list li {
    position: relative;
    padding-left: var(--spacing-5);
    margin-bottom: var(--spacing-2);
    line-height: var(--line-height-relaxed);
}

.alert__list li::before {
    content: '✓';
    position: absolute;
    left: 0;
    color: var(--color-primary-500);
    font-weight: var(--font-weight-bold);
}

.alert__list li:last-child {
    margin-bottom: 0;
}

/* ===================================
   PAGE NAVIGATION (PREV/NEXT)
   =================================== */

.page-nav {
    display: flex;
    justify-content: space-between;
    gap: var(--spacing-4);
    margin-top: var(--spacing-10);
    padding-top: var(--spacing-8);
    border-top: var(--border-width-1) solid var(--color-border);
}

.page-nav__link {
    display: flex;
    align-items: center;
    gap: var(--spacing-3);
    padding: var(--spacing-5) var(--spacing-6);
    background: var(--color-surface);
    border-radius: var(--radius-card);
    border: var(--border-width-1) solid rgba(59, 130, 246, 0.1);
    box-shadow: var(--shadow-sm);
    text-decoration: none;
    transition: var(--transition-base);
    flex: 1;
    max-width: 45%;
}

.page-nav__link:hover {
    box-shadow: var(--shadow-card-hover);
    transform: translateY(-4px);
    border-color: var(--color-primary-300);
}

.page-nav__link span {
    display: flex;
    flex-direction: column;
    gap: var(--spacing-1);
}

.page-nav__link small {
    font-size: var(--font-size-xs);
    color: var(--color-text-muted);
    font-weight: var(--font-weight-medium);
    text-transform: uppercase;
    letter-spacing: var(--letter-spacing-wide);
}

.page-nav__link strong {
    font-size: var(--font-size-base);
    color: var(--color-primary-500);
    font-weight: var(--font-weight-semibold);
    line-height: var(--line-height-tight);
}

.page-nav__link i {
    font-size: var(--font-size-xl);
    color: var(--color-primary-500);
    transition: var(--transition-transform);
}

.page-nav__link--prev:hover i {
    transform: translateX(-4px);
}

.page-nav__link--next {
    text-align: right;
}

.page-nav__link--next:hover i {
    transform: translateX(4px);
}

/* ===================================
   RESPONSIVE - TABLET
   =================================== */

@media (max-width: 991px) {
    .docs-feature__sidebar {
        width: 260px;
    }

    .docs-feature__main {
        margin-left: 260px;
    }

    .docs-hero--feature {
        padding: var(--spacing-6) 0 var(--spacing-8);
    }

    .docs-content {
        padding: var(--section-padding-sm);
    }

    .docs-hero--feature .docs-hero__header {
        gap: var(--spacing-3);
    }

    .docs-hero--feature .docs-hero__icon-wrapper {
        width: 56px;
        height: 56px;
    }

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

    .step-card {
        flex-direction: column;
        padding: var(--spacing-6);
    }

    .step-card__number {
        width: 56px;
        height: 56px;
        font-size: var(--font-size-2xl);
    }

    .feature-grid {
        grid-template-columns: repeat(auto-fit, minmax(220px, 1fr));
        gap: var(--spacing-5);
    }

    .next-steps-grid {
        grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
        gap: var(--spacing-5);
    }
}

/* ===================================
   RESPONSIVE - MOBILE
   =================================== */

@media (max-width: 767px) {
    /* Hide sidebar by default on mobile */
    .docs-feature__sidebar {
        transform: translateX(-100%);
        width: 280px;
        top: var(--header-height, 70px);
        height: calc(100vh - var(--header-height, 70px));
    }

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

    .docs-feature__main {
        margin-left: 0;
        width: 100%;
    }

    /* Show close button in sidebar */
    .docs-sidebar__close {
        display: block;
    }

    .docs-hero--feature {
        padding: var(--spacing-5) 0 var(--spacing-6);
    }

    .docs-content {
        padding: var(--section-padding-xs);
    }

    .docs-hero--feature .docs-hero__header {
        flex-direction: column;
        align-items: flex-start;
        gap: var(--spacing-3);
    }

    .docs-hero--feature .docs-hero__icon-wrapper {
        width: 48px;
        height: 48px;
    }

    .docs-hero--feature .docs-hero__icon {
        font-size: var(--font-size-xl);
    }

    .docs-hero__stats {
        gap: var(--spacing-3);
    }

    .stat-badge {
        padding: var(--spacing-2) var(--spacing-3);
        font-size: var(--font-size-xs);
    }

    .content-block {
        margin-bottom: var(--spacing-8);
    }

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

    .feature-grid {
        grid-template-columns: 1fr;
        gap: var(--spacing-4);
    }

    .step-card {
        padding: var(--spacing-5);
    }

    .step-card__number {
        width: 48px;
        height: 48px;
        font-size: var(--font-size-xl);
    }

    .step-card__title {
        font-size: var(--font-size-xl);
    }

    .next-steps-grid {
        grid-template-columns: 1fr;
        gap: var(--spacing-4);
    }

    .help-card {
        flex-direction: column;
        text-align: center;
    }

    .help-card__icon {
        margin: 0 auto;
    }

    .page-nav {
        flex-direction: column;
        gap: var(--spacing-4);
    }

    .page-nav__link {
        max-width: 100%;
    }

    .page-nav__link--next {
        flex-direction: row-reverse;
    }
}

/* ===================================
   RESPONSIVE - SMALL MOBILE
   =================================== */

@media (max-width: 575px) {
    .docs-sidebar {
        padding: var(--spacing-4) 0;
    }

    .docs-sidebar__header,
    .docs-sidebar__title {
        padding-left: var(--spacing-4);
        padding-right: var(--spacing-4);
    }

    .docs-sidebar__nav {
        padding: 0 var(--spacing-3);
    }

    .docs-sidebar__footer {
        padding: var(--spacing-4);
    }

    .breadcrumb {
        margin-bottom: var(--spacing-4);
    }

    .breadcrumb__item {
        font-size: var(--font-size-xs);
    }

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

    .step-card__title {
        flex-direction: column;
        align-items: flex-start;
    }

    .page-nav__link {
        padding: var(--spacing-4) var(--spacing-5);
    }
}

/* ===================================
   SIDEBAR OVERLAY (MOBILE)
   =================================== */

.sidebar-overlay {
    display: none;
    position: fixed;
    top: var(--header-height, 70px);
    left: 0;
    right: 0;
    bottom: 0;
    background: rgba(0, 0, 0, 0.5);
    z-index: calc(var(--z-index-sticky) - 11);
    opacity: 0;
    transition: var(--transition-base);
}

.sidebar-overlay.active {
    display: block;
    opacity: 1;
}

@media (max-width: 767px) {
    .sidebar-overlay {
        display: block;
    }
}

/* ===================================
   FOCUS STATES (ACCESSIBILITY)
   =================================== */

.docs-nav__link:focus-visible,
.step-card__link:focus-visible,
.next-step-card:focus-visible,
.page-nav__link:focus-visible,
.breadcrumb__link:focus-visible {
    outline: 2px solid var(--color-primary-500);
    outline-offset: 3px;
}

/* ===================================
   PRINT STYLES
   =================================== */

@media print {
    .docs-feature__sidebar,
    .docs-hero__stats,
    .breadcrumb,
    .page-nav,
    .help-card {
        display: none !important;
    }

    .docs-feature__main {
        margin-left: 0;
    }

    .docs-hero--feature {
        background: transparent;
        padding: var(--spacing-4) 0;
        border-bottom: var(--border-width-1) solid var(--color-border);
    }

    .docs-hero--feature .docs-hero__title,
    .docs-hero--feature .docs-hero__subtitle {
        color: var(--color-text-primary);
    }

    .docs-content {
        padding: var(--spacing-4) 0;
    }

    .step-card,
    .feature-item,
    .next-step-card {
        page-break-inside: avoid;
        box-shadow: none;
        border: var(--border-width-1) solid var(--color-border);
    }

    .step-card::before,
    .next-step-card::before {
        display: none;
    }

    .step-card:hover,
    .feature-item:hover,
    .next-step-card:hover {
        transform: none;
        box-shadow: none;
    }
}