/* ==========================================================================
   Mail System by Katsarov Design - Documentation Subpage Styles
   Builds on styles.css (design tokens, header, footer) and adds the layout
   and article typography used by the themed documentation pages.
   ========================================================================== */

.doc-body {
    background-color: var(--color-white);
}

/* ==========================================================================
   Page shell: breadcrumb + hero
   ========================================================================== */

.doc-main {
    padding: var(--spacing-8) 0 var(--spacing-20);
}

.breadcrumb {
    display: flex;
    align-items: center;
    flex-wrap: wrap;
    gap: var(--spacing-2);
    font-size: var(--font-size-sm);
    color: var(--color-gray-500);
    margin-bottom: var(--spacing-6);
}

.breadcrumb a {
    color: var(--color-gray-600);
    font-weight: 500;
}

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

.breadcrumb .sep {
    color: var(--color-gray-400);
}

.breadcrumb .current {
    color: var(--color-gray-800);
    font-weight: 600;
}

.doc-hero {
    max-width: 820px;
    margin-bottom: var(--spacing-10);
    padding-bottom: var(--spacing-8);
    border-bottom: 1px solid var(--color-gray-200);
}

.doc-eyebrow {
    display: inline-block;
    font-size: var(--font-size-xs);
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--color-primary);
    background-color: #e8f3ff;
    border: 1px solid #b7d7ef;
    padding: var(--spacing-1) var(--spacing-3);
    border-radius: var(--radius-full);
    margin-bottom: var(--spacing-4);
}

.doc-hero h1 {
    font-size: clamp(2rem, 4vw, 2.75rem);
    font-weight: 700;
    line-height: 1.15;
    color: var(--color-gray-900);
    margin-bottom: var(--spacing-4);
}

.doc-lead {
    font-size: var(--font-size-lg);
    color: var(--color-gray-600);
    line-height: 1.7;
}

/* ==========================================================================
   Two-column layout: sticky TOC sidebar + article
   ========================================================================== */

.doc-layout {
    display: grid;
    grid-template-columns: 240px minmax(0, 1fr);
    gap: var(--spacing-16);
    align-items: start;
}

.doc-sidebar {
    position: sticky;
    top: 96px;
    align-self: start;
}

.doc-toc-toggle {
    display: none;
    width: 100%;
    align-items: center;
    justify-content: space-between;
    gap: var(--spacing-2);
    padding: var(--spacing-3) var(--spacing-4);
    font-family: inherit;
    font-size: var(--font-size-sm);
    font-weight: 600;
    color: var(--color-gray-700);
    background-color: var(--color-gray-100);
    border: 1px solid var(--color-gray-300);
    border-radius: var(--radius-md);
    cursor: pointer;
}

.doc-toc-toggle::after {
    content: "▾";
    transition: transform var(--transition-fast);
}

.doc-toc-toggle[aria-expanded="true"]::after {
    transform: rotate(180deg);
}

.doc-toc-title {
    font-size: var(--font-size-xs);
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.06em;
    color: var(--color-gray-500);
    margin-bottom: var(--spacing-3);
}

.doc-toc ul {
    list-style: none;
    border-left: 2px solid var(--color-gray-200);
}

.doc-toc li {
    margin: 0;
}

.doc-toc a {
    display: block;
    padding: var(--spacing-2) var(--spacing-4);
    margin-left: -2px;
    border-left: 2px solid transparent;
    font-size: var(--font-size-sm);
    color: var(--color-gray-600);
    line-height: 1.4;
    transition: color var(--transition-fast), border-color var(--transition-fast);
}

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

.doc-toc a.active {
    color: var(--color-primary-dark);
    font-weight: 600;
    border-left-color: var(--color-primary);
}

/* ==========================================================================
   Article typography
   ========================================================================== */

.doc-content {
    min-width: 0;
    max-width: 820px;
    color: var(--color-gray-700);
    font-size: var(--font-size-base);
    line-height: 1.75;
}

.doc-content > *:first-child {
    margin-top: 0;
}

.doc-heading {
    position: relative;
    scroll-margin-top: 96px;
    color: var(--color-gray-900);
    font-weight: 700;
    line-height: 1.3;
}

.doc-h2 {
    font-size: var(--font-size-2xl);
    margin-top: var(--spacing-12);
    padding-bottom: var(--spacing-3);
    border-bottom: 1px solid var(--color-gray-200);
    margin-bottom: var(--spacing-5);
}

.doc-h3 {
    font-size: var(--font-size-xl);
    margin-top: var(--spacing-8);
    margin-bottom: var(--spacing-4);
}

.doc-h4 {
    font-size: var(--font-size-lg);
    margin-top: var(--spacing-6);
    margin-bottom: var(--spacing-3);
}

.heading-anchor {
    position: absolute;
    left: -1.25em;
    top: 0;
    padding-right: 0.35em;
    color: var(--color-gray-400);
    font-weight: 400;
    opacity: 0;
    transition: opacity var(--transition-fast);
}

.doc-heading:hover .heading-anchor,
.heading-anchor:focus {
    opacity: 1;
}

.doc-content p {
    margin: var(--spacing-4) 0;
}

.doc-content ul,
.doc-content ol {
    margin: var(--spacing-4) 0;
    padding-left: var(--spacing-6);
}

.doc-content li {
    margin: var(--spacing-2) 0;
}

.doc-content li > ul,
.doc-content li > ol {
    margin: var(--spacing-2) 0;
}

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

.doc-content a {
    color: var(--color-primary);
    font-weight: 500;
    text-decoration: underline;
    text-decoration-color: var(--color-gray-300);
    text-underline-offset: 2px;
}

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

.doc-content hr {
    border: none;
    border-top: 1px solid var(--color-gray-200);
    margin: var(--spacing-10) 0;
}

/* Inline code */
.doc-content :not(pre) > code {
    padding: 0.15em 0.4em;
    background-color: var(--color-gray-100);
    border: 1px solid var(--color-gray-200);
    border-radius: var(--radius-sm);
    font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
    font-size: 0.85em;
    color: var(--color-primary-dark);
    white-space: nowrap;
}

/* ==========================================================================
   Callouts (blockquotes)
   ========================================================================== */

.doc-content blockquote {
    position: relative;
    margin: var(--spacing-6) 0;
    padding: var(--spacing-5) var(--spacing-6);
    background-color: #f2f8fe;
    border: 1px solid #cfe4f7;
    border-left: 4px solid var(--color-primary);
    border-radius: var(--radius-md);
    color: var(--color-gray-700);
}

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

.doc-content blockquote p + p {
    margin-top: var(--spacing-3);
}

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

/* ==========================================================================
   Tables
   ========================================================================== */

.table-wrap {
    margin: var(--spacing-5) 0;
    overflow-x: auto;
    border: 1px solid var(--color-gray-200);
    border-radius: var(--radius-md);
}

.doc-content table {
    width: 100%;
    border-collapse: collapse;
    font-size: var(--font-size-sm);
}

.doc-content thead {
    background-color: var(--color-gray-100);
}

.doc-content th {
    text-align: left;
    font-weight: 600;
    color: var(--color-gray-800);
    padding: var(--spacing-3) var(--spacing-4);
    white-space: nowrap;
    border-bottom: 1px solid var(--color-gray-300);
}

.doc-content td {
    padding: var(--spacing-3) var(--spacing-4);
    border-bottom: 1px solid var(--color-gray-200);
    color: var(--color-gray-600);
    vertical-align: top;
}

.doc-content tbody tr:last-child td {
    border-bottom: none;
}

.doc-content tbody tr:nth-child(even) {
    background-color: var(--color-gray-100);
}

.doc-content td code,
.doc-content th code {
    white-space: nowrap;
}

/* ==========================================================================
   Code blocks (dark cards; enhanced by highlight.js when available)
   ========================================================================== */

.code-block {
    position: relative;
    margin: var(--spacing-5) 0;
}

.doc-content pre {
    margin: 0;
    background-color: #0d1117;
    border: 1px solid #21262d;
    border-radius: var(--radius-md);
    overflow: hidden;
}

.doc-content pre code {
    display: block;
    padding: var(--spacing-5);
    overflow-x: auto;
    background: transparent;
    color: #e6edf3;
    font-family: 'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
    font-size: 0.83rem;
    line-height: 1.7;
    white-space: pre;
    tab-size: 4;
}

.code-copy {
    position: absolute;
    top: var(--spacing-3);
    right: var(--spacing-3);
    display: inline-flex;
    align-items: center;
    gap: var(--spacing-1);
    padding: var(--spacing-1) var(--spacing-3);
    font-family: inherit;
    font-size: var(--font-size-xs);
    font-weight: 600;
    color: #c9d1d9;
    background-color: rgba(255, 255, 255, 0.08);
    border: 1px solid rgba(255, 255, 255, 0.15);
    border-radius: var(--radius-sm);
    cursor: pointer;
    opacity: 0;
    transition: opacity var(--transition-fast), background-color var(--transition-fast);
}

.code-block:hover .code-copy,
.code-copy:focus {
    opacity: 1;
}

.code-copy:hover {
    background-color: rgba(255, 255, 255, 0.16);
}

.code-copy.copied {
    color: #56d364;
    border-color: rgba(86, 211, 100, 0.4);
}

/* ==========================================================================
   Responsive
   ========================================================================== */

@media (max-width: 960px) {
    .doc-layout {
        grid-template-columns: 1fr;
        gap: var(--spacing-6);
    }

    .doc-sidebar {
        position: static;
        top: auto;
    }

    .doc-toc-toggle {
        display: flex;
    }

    .doc-toc {
        display: none;
        margin-top: var(--spacing-3);
        padding: var(--spacing-2) 0;
        border: 1px solid var(--color-gray-200);
        border-radius: var(--radius-md);
    }

    .doc-toc.open {
        display: block;
    }

    .doc-toc-title {
        display: none;
    }

    .doc-toc ul {
        border-left: none;
    }

    .code-copy {
        opacity: 1;
    }
}

@media (max-width: 768px) {
    .doc-main {
        padding: var(--spacing-6) 0 var(--spacing-16);
    }

    .heading-anchor {
        display: none;
    }
}