/* ========================================
   Documentation-Specific Styles
   Layout, sidebar, ToC, content area, feedback
   ======================================== */

/* ========================================
   Skip-to-Content Link
   ======================================== */

.skip-to-content {
    position: absolute;
    left: -9999px;
    top: auto;
    width: 1px;
    height: 1px;
    overflow: hidden;
    z-index: 9999;
}

.skip-to-content:focus {
    position: fixed;
    top: 8px;
    left: 8px;
    width: auto;
    height: auto;
    padding: 8px 16px;
    background: var(--color-primary);
    color: var(--text-primary);
    font-size: 14px;
    font-weight: 600;
    border-radius: 4px;
    text-decoration: none;
    z-index: 9999;
    outline: 2px solid #fff;
}

/* ========================================
   Visually Hidden (screen reader only)
   ======================================== */

.visually-hidden {
    position: absolute;
    width: 1px;
    height: 1px;
    padding: 0;
    margin: -1px;
    overflow: hidden;
    clip: rect(0, 0, 0, 0);
    white-space: nowrap;
    border: 0;
}

/* ========================================
   Documentation Layout
   ======================================== */

.docs-layout {
    display: flex;
    min-height: 100vh;
    background: var(--gradient-bg);
}

/* ========================================
   Header
   ======================================== */

.docs-header {
    position: fixed;
    top: 0;
    left: 0;
    right: 0;
    height: 64px;
    background: var(--glass-bg);
    backdrop-filter: blur(24px);
    -webkit-backdrop-filter: blur(24px);
    border-bottom: 1px solid var(--glass-border);
    display: flex;
    align-items: center;
    padding: 0 var(--space-lg);
    z-index: 1000;
}

.docs-header__logo {
    height: 32px;
    display: flex;
    align-items: center;
    gap: var(--space-sm);
}

.docs-header__logo-img {
    height: 32px;
    width: auto;
}

.docs-header__logo-text {
    font-family: var(--font-display);
    font-size: 1.125rem;
    font-weight: 600;
    color: var(--text-primary);
}

.docs-header__search {
    flex: 1;
    max-width: 400px;
    margin: 0 var(--space-xl);
}

.docs-header__actions {
    display: flex;
    align-items: center;
    gap: var(--space-md);
}

/* Mobile menu toggle button */
.docs-header__menu-toggle {
    display: none;
    background: transparent;
    border: none;
    color: var(--text-secondary);
    font-size: 1.25rem;
    padding: var(--space-sm);
    cursor: pointer;
    border-radius: var(--radius-sm);
    transition: all var(--transition-fast);
}

.docs-header__menu-toggle:hover {
    background: var(--glass-bg-light);
    color: var(--color-primary);
}

/* Mobile search toggle button (hidden on desktop) */
.docs-header__search-toggle {
    display: none;
    align-items: center;
    justify-content: center;
    width: 44px;
    height: 44px;
    background: transparent;
    border: none;
    color: var(--text-secondary);
    font-size: 1.125rem;
    cursor: pointer;
    border-radius: var(--radius-sm);
    transition: all var(--transition-fast);
}

.docs-header__search-toggle:hover {
    background: var(--glass-bg-light);
    color: var(--color-primary);
}

/* Mobile search overlay */
.docs-mobile-search {
    position: fixed;
    top: 64px;
    left: 0;
    right: 0;
    z-index: 1001;
    background: var(--color-bg-dark-secondary);
    border-bottom: 1px solid var(--glass-border);
    padding: var(--space-md);
    animation: fadeIn 0.2s ease;
}

.docs-mobile-search__container {
    display: flex;
    align-items: center;
    gap: var(--space-sm);
}

.docs-mobile-search__container .docs-search {
    flex: 1;
}

.docs-mobile-search__close {
    display: flex;
    align-items: center;
    justify-content: center;
    width: 44px;
    height: 44px;
    flex-shrink: 0;
    background: transparent;
    border: none;
    color: var(--text-secondary);
    font-size: 1.125rem;
    cursor: pointer;
    border-radius: var(--radius-sm);
    transition: all var(--transition-fast);
}

.docs-mobile-search__close:hover {
    background: var(--glass-bg-light);
    color: var(--text-primary);
}

/* ========================================
   Sidebar
   ======================================== */

.docs-sidebar {
    position: fixed;
    top: 64px;
    left: 0;
    bottom: 0;
    width: 280px;
    background: var(--glass-bg);
    backdrop-filter: blur(24px);
    -webkit-backdrop-filter: blur(24px);
    border-right: 1px solid var(--glass-border);
    overflow-y: auto;
    padding: var(--space-lg);
    z-index: 100;
    transition: transform var(--transition-base);
}

.docs-sidebar__section {
    margin-bottom: var(--space-lg);
}

.docs-sidebar__section-title {
    display: flex;
    align-items: center;
    gap: var(--space-sm);
    font-family: var(--font-display);
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--text-muted);
    margin-bottom: var(--space-sm);
    padding: 0 var(--space-sm);
}

.docs-sidebar__pages {
    list-style: none;
    padding: 0;
    margin: 0;
    display: flex;
    flex-direction: column;
    gap: 2px;
}

.docs-sidebar__link {
    position: relative;
    display: flex;
    align-items: center;
    gap: var(--space-sm);
    padding: var(--space-sm) var(--space-md);
    border-radius: var(--radius-sm);
    color: var(--text-secondary);
    text-decoration: none;
    font-size: 0.875rem;
    transition: all var(--transition-fast);
}

.docs-sidebar__link:hover {
    background: var(--glass-bg-light);
    color: var(--text-primary);
}

.docs-sidebar__link--active {
    background: rgba(230, 122, 46, 0.15);
    color: var(--color-primary);
}

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

/* Nested navigation items */
.docs-sidebar__nested {
    margin-left: var(--space-md);
    padding-left: var(--space-md);
    border-left: 1px solid var(--glass-border);
}

.docs-sidebar__nested .docs-sidebar__link {
    font-size: 0.8125rem;
    padding: var(--space-xs) var(--space-md);
}

/* ========================================
   Main Content
   ======================================== */

.docs-content {
    margin-left: 280px;
    margin-top: 64px;
    flex: 1;
    padding: var(--space-xl);
    min-height: calc(100vh - 64px);
}

.docs-content__wrapper {
    max-width: 800px;
    margin: 0 auto;
}

/* With ToC visible */
.docs-content--with-toc {
    margin-right: 240px;
}

/* ========================================
   Article Meta
   ======================================== */

.article-meta {
    display: flex;
    align-items: center;
    gap: var(--space-md);
    margin-bottom: var(--space-lg);
    color: var(--text-muted);
    font-size: 13px;
}

.reading-time {
    display: flex;
    align-items: center;
    gap: 6px;
}

/* Article styles are in Doc.razor.css (scoped to the page component) */

/* ========================================
   Code Blocks (Prism.js overrides + copy button)
   ======================================== */

.docs-article pre[class*="language-"],
.docs-article pre:has(> code[class*="language-"]) {
    background: rgba(0, 0, 0, 0.3);
    border: 1px solid var(--glass-border);
    border-radius: var(--radius-md);
    margin: var(--space-md) 0;
}

.docs-article code[class*="language-"],
.docs-article pre[class*="language-"] {
    font-size: 0.875rem;
}

.docs-article pre {
    position: relative;
}

.copy-btn {
    position: absolute;
    top: 8px;
    right: 8px;
    display: flex;
    align-items: center;
    gap: 4px;
    padding: 4px 8px;
    font-size: 12px;
    font-family: var(--font-body);
    background: rgba(255, 255, 255, 0.1);
    border: 1px solid rgba(255, 255, 255, 0.2);
    border-radius: 4px;
    color: rgba(255, 255, 255, 0.7);
    cursor: pointer;
    opacity: 0;
    transition: opacity 0.2s ease, color 0.2s ease, border-color 0.2s ease;
    z-index: 1;
    line-height: 1;
}

pre:hover .copy-btn,
.copy-btn:focus {
    opacity: 1;
}

.copy-btn:hover {
    background: rgba(255, 255, 255, 0.15);
    color: rgba(255, 255, 255, 0.9);
}

.copy-btn.copied {
    color: var(--color-success);
    border-color: var(--color-success);
}

/* ========================================
   Table of Contents
   ======================================== */

.docs-toc-container {
    position: fixed;
    top: 64px;
    right: 0;
    bottom: 0;
    width: 240px;
    padding: var(--space-lg);
    overflow-y: auto;
}

.docs-toc {
    /* Inner nav element - no positioning needed */
}

.docs-toc__title {
    font-family: var(--font-display);
    font-size: 0.75rem;
    font-weight: 600;
    text-transform: uppercase;
    letter-spacing: 0.05em;
    color: var(--text-muted);
    margin-bottom: var(--space-md);
}

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

.docs-toc__item {
    margin-bottom: var(--space-xs);
}

.docs-toc__link {
    display: block;
    width: 100%;
    padding: var(--space-xs) 0;
    color: var(--text-muted);
    font-size: 0.8125rem;
    text-decoration: none;
    text-align: left;
    background: none;
    border: none;
    border-left: 2px solid transparent;
    padding-left: var(--space-sm);
    cursor: pointer;
    transition: all var(--transition-fast);
}

.docs-toc__link:hover {
    color: var(--text-secondary);
}

.docs-toc__link--active {
    color: var(--color-primary);
    border-left-color: var(--color-primary);
}

.docs-toc__link--level-3 {
    padding-left: var(--space-lg);
}

.docs-toc__link--level-4 {
    padding-left: calc(var(--space-lg) + var(--space-sm));
}

/* Feedback widget styles are in FeedbackWidget.razor.css (scoped) */

/* ========================================
   Search
   ======================================== */

.docs-search {
    position: relative;
}

.docs-search__input {
    width: 100%;
    padding: var(--space-sm) var(--space-md);
    padding-left: 36px;
    background: var(--glass-bg-light);
    border: 1px solid var(--glass-border);
    border-radius: var(--radius-md);
    color: var(--text-primary);
    font-size: 0.875rem;
    transition: all var(--transition-fast);
}

.docs-search__input:focus {
    outline: none;
    border-color: var(--color-primary);
    box-shadow: 0 0 0 3px var(--color-primary-glow);
}

.docs-search__input::placeholder {
    color: var(--text-muted);
}

.docs-search__icon {
    position: absolute;
    left: var(--space-md);
    top: 50%;
    transform: translateY(-50%);
    color: var(--text-muted);
    pointer-events: none;
}

.docs-search__results {
    position: absolute;
    top: 100%;
    left: 0;
    right: 0;
    background: var(--color-bg-dark-secondary);
    border: 1px solid var(--glass-border);
    border-radius: var(--radius-md);
    margin-top: var(--space-xs);
    max-height: 400px;
    overflow-y: auto;
    box-shadow: 0 8px 32px var(--glass-shadow);
    z-index: 1001;
}

.docs-search__result {
    padding: var(--space-md);
    border-bottom: 1px solid var(--glass-border);
    cursor: pointer;
    transition: background var(--transition-fast);
}

.docs-search__result:last-child {
    border-bottom: none;
}

.docs-search__result:hover,
.docs-search__result--selected {
    background: var(--glass-bg-light);
}

.docs-search__result-title {
    font-weight: 600;
    color: var(--text-primary);
    margin-bottom: var(--space-xs);
}

.docs-search__result-section {
    font-size: 0.75rem;
    color: var(--text-muted);
    margin-bottom: var(--space-xs);
}

.docs-search__result-snippet {
    font-size: 0.8125rem;
    color: var(--text-secondary);
}

.docs-search__result-snippet mark {
    background: rgba(230, 122, 46, 0.3);
    color: var(--text-primary);
    padding: 0 2px;
    border-radius: 2px;
}

.docs-search__empty {
    padding: var(--space-lg);
    text-align: center;
    color: var(--text-muted);
    font-size: 0.875rem;
}

.docs-search__kbd {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 20px;
    height: 20px;
    padding: 0 var(--space-xs);
    background: var(--glass-bg);
    border: 1px solid var(--glass-border);
    border-radius: 4px;
    font-size: 0.75rem;
    color: var(--text-muted);
    font-family: inherit;
    margin-left: var(--space-sm);
}

/* Not translated banner styles are in NotTranslatedBanner.razor.css (scoped) */

/* ========================================
   Footer
   ======================================== */

.docs-footer {
    margin-top: var(--space-2xl);
    padding: var(--space-lg);
    text-align: center;
    color: var(--text-muted);
    font-size: 0.8125rem;
}

.docs-footer a {
    color: var(--text-secondary);
}

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

/* ========================================
   Language Picker
   ======================================== */

.docs-language-picker {
    min-width: 130px;
}

/* ========================================
   Mobile Menu Backdrop
   ======================================== */

.docs-mobile-backdrop {
    display: none;
    position: fixed;
    top: 64px;
    left: 0;
    right: 0;
    bottom: 0;
    background: rgba(0, 0, 0, 0.6);
    backdrop-filter: blur(4px);
    -webkit-backdrop-filter: blur(4px);
    z-index: 99;
    animation: fadeIn 0.3s ease;
}

/* ========================================
   Mobile ToC (shown at top of content on mobile)
   ======================================== */

.docs-mobile-toc {
    display: none;
    margin-bottom: var(--space-lg);
}

.docs-mobile-toc__toggle {
    display: flex;
    align-items: center;
    justify-content: space-between;
    width: 100%;
    padding: var(--space-md);
    background: var(--glass-bg);
    border: 1px solid var(--glass-border);
    border-radius: var(--radius-md);
    color: var(--text-secondary);
    cursor: pointer;
    font-size: 0.875rem;
    transition: all var(--transition-fast);
}

.docs-mobile-toc__toggle:hover {
    background: var(--glass-bg-light);
}

.docs-mobile-toc__toggle-icon {
    transition: transform var(--transition-fast);
}

.docs-mobile-toc__toggle--open .docs-mobile-toc__toggle-icon {
    transform: rotate(180deg);
}

.docs-mobile-toc__content {
    padding: var(--space-md);
    background: var(--glass-bg);
    border: 1px solid var(--glass-border);
    border-top: none;
    border-radius: 0 0 var(--radius-md) var(--radius-md);
}

/* ========================================
   Responsive - Large Tablet (1200px)
   Hide ToC, expand content
   ======================================== */

@media (max-width: 1200px) {
    .docs-toc-container {
        display: none;
    }

    .docs-content {
        margin-right: 0;
    }

    .docs-content--with-toc {
        margin-right: 0;
    }

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

/* ========================================
   Responsive - Tablet (768px)
   Hide sidebar, show hamburger menu
   ======================================== */

@media (max-width: 768px) {
    .docs-header__menu-toggle {
        display: flex;
    }

    .docs-header__search {
        display: none;
    }

    .docs-header__search-toggle {
        display: flex;
    }

    .docs-sidebar {
        transform: translateX(-100%);
    }

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

    .docs-mobile-backdrop--open {
        display: block;
    }

    .docs-content {
        margin-left: 0;
        padding: var(--space-md);
    }

    .docs-article {
        padding: var(--space-lg);
    }

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

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

    /* Touch target sizing for sidebar links */
    .docs-sidebar__link {
        min-height: 44px;
        padding: var(--space-sm) var(--space-md);
    }

    .docs-sidebar__nested .docs-sidebar__link {
        min-height: 40px;
    }

    /* Touch target sizing for ToC links */
    .docs-toc__link {
        min-height: 40px;
        display: flex;
        align-items: center;
    }

    /* Touch target sizing for mobile ToC toggle */
    .docs-mobile-toc__toggle {
        min-height: 44px;
    }
}

/* ========================================
   Responsive - Mobile (480px)
   Compact layout
   ======================================== */

@media (max-width: 480px) {
    .docs-header {
        padding: 0 var(--space-md);
    }

    .docs-header__logo-text {
        display: none;
    }

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

    .docs-article {
        padding: var(--space-md);
        border-radius: var(--radius-md);
    }

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

    .docs-feedback__buttons {
        flex-wrap: wrap;
    }
}

/* ========================================
   Reduced Motion
   ======================================== */

@media (prefers-reduced-motion: reduce) {
    .docs-article {
        animation: none;
    }

    .docs-mobile-backdrop {
        animation: none;
    }

    .docs-mobile-toc__toggle-icon {
        transition: none;
    }

    .docs-sidebar {
        transition: none;
    }

    .docs-sidebar__link,
    .docs-search__input,
    .docs-search__result,
    .docs-feedback__btn,
    .docs-mobile-toc__toggle,
    .docs-header__menu-toggle,
    .docs-toc__link {
        transition: none;
    }

    .docs-mobile-search {
        animation: none;
    }
}

@media print {
    .docs-header,
    .docs-sidebar,
    .docs-toc-container,
    .docs-mobile-toc,
    .docs-feedback,
    .docs-footer,
    .copy-btn {
        display: none !important;
    }

    .docs-content {
        margin: 0 !important;
        padding: 0 !important;
    }

    .docs-article {
        background: white !important;
        border: none !important;
        box-shadow: none !important;
        padding: 0 !important;
    }

    .docs-article h1,
    .docs-article h2,
    .docs-article h3,
    .docs-article h4 {
        color: black !important;
    }

    .docs-article p,
    .docs-article li {
        color: #333 !important;
    }

    a {
        color: black !important;
        text-decoration: underline !important;
    }
}
