/* ========================================
   Technical Documentation Styles
   Hub page, two-column layout, TOC,
   diagrams, callouts, tables, code blocks
   ======================================== */

/* ========================================
   1. HUB PAGE — Card Grid
   ======================================== */

.technical-docs-hub {
    max-width: var(--container-lg);
    margin: 0 auto;
    padding: var(--space-11) var(--space-4) var(--space-9);
}

.technical-docs-hub__header {
    margin-bottom: var(--space-8);
    padding-bottom: var(--space-6);
    border-bottom: 1px solid var(--medium-gray);
}

.technical-docs-hub__title {
    font-size: var(--text-5xl);
    font-weight: 300;
    color: var(--text-bright-gray);
    margin: 0 0 var(--space-3) 0;
    letter-spacing: -0.02em;
    line-height: var(--leading-tight);
}

.technical-docs-hub__subtitle {
    font-size: var(--text-xl);
    color: var(--text-subtle);
    margin: 0;
    font-weight: var(--font-normal);
    line-height: 1.6;
}

/* Group sections */
.technical-docs-hub__group {
    margin-bottom: var(--space-8);
}

.technical-docs-hub__group-label {
    font-size: var(--text-sm);
    font-weight: var(--font-semibold);
    color: var(--accent-orange);
    text-transform: uppercase;
    letter-spacing: 0.1em;
    margin-bottom: var(--space-5);
    padding-bottom: var(--space-3);
    border-bottom: 1px solid var(--medium-gray);
}

/* Card grid */
.technical-docs-hub__grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: var(--space-5);
}

/* Card */
.technical-docs-card {
    display: flex;
    flex-direction: column;
    background: var(--secondary-dark);
    border: 1px solid var(--medium-gray);
    padding: var(--space-5);
    text-decoration: none;
    transition: border-color 0.2s ease, transform 0.2s ease;
}

.technical-docs-card:hover {
    border-color: var(--accent-orange);
    transform: translateY(-2px);
    text-decoration: none;
}

.technical-docs-card__tag {
    display: inline-block;
    font-size: 0.7rem;
    font-weight: 600;
    color: var(--accent-orange);
    text-transform: uppercase;
    letter-spacing: 0.08em;
    margin-bottom: var(--space-3);
}

.technical-docs-card__title {
    font-size: var(--text-xl);
    font-weight: 400;
    color: var(--text-bright-gray);
    margin: 0 0 var(--space-3) 0;
    line-height: var(--leading-snug);
}

.technical-docs-card__description {
    font-size: var(--text-sm);
    color: var(--light-gray);
    line-height: 1.6;
    margin: 0 0 var(--space-4) 0;
    flex: 1;
}


/* ========================================
   2. TWO-COLUMN LAYOUT — Content + TOC
   ======================================== */

/* Override article.css max-width for two-column layout */
.article.article--technical-doc {
    max-width: var(--container-lg);
}

/* Match site heading weights (main.css uses 300/300/400, article.css overrides to 700/600/600) */
/* Double class for specificity: .article.article--technical-doc beats .article alone */
.article.article--technical-doc h1,
.article.article--technical-doc .article__title {
    font-weight: 300;
}

.article.article--technical-doc h2 {
    font-weight: 300;
}

.article.article--technical-doc h3 {
    font-weight: 400;
}

/* Offset scroll target so heading clears fixed header + breadcrumb */
.article--technical-doc .article__section[id] {
    scroll-margin-top: 140px;
}

.technical-doc-layout {
    max-width: var(--container-lg);
    margin: 0 auto;
}

.technical-doc-content {
    min-width: 0; /* Prevent grid blowout */
}

/* Meta line (last updated) */
.technical-doc-meta {
    margin-top: var(--space-3);
    font-size: var(--text-sm);
    color: var(--light-gray);
}

/* ========================================
   3. TABLE OF CONTENTS — Right Rail
   ======================================== */

.technical-doc-toc {
    position: relative;
}

.toc {
    position: sticky;
    top: 100px;
    max-height: calc(100vh - 120px);
    overflow-y: auto;
}

.toc__title {
    font-size: var(--text-sm);
    font-weight: var(--font-semibold);
    color: var(--light-gray);
    text-transform: uppercase;
    letter-spacing: 0.08em;
    margin: 0 0 var(--space-4) 0;
    padding-bottom: var(--space-3);
    border-bottom: 1px solid var(--medium-gray);
}

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

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

.toc__link {
    display: block;
    padding: var(--space-2) var(--space-3);
    font-size: var(--text-sm);
    color: var(--light-gray);
    text-decoration: none;
    border-left: 2px solid transparent;
    transition: color 0.2s ease, border-color 0.2s ease;
    line-height: 1.4;
}

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

.toc__link--active {
    color: var(--accent-orange);
    border-left-color: var(--accent-orange);
}

/* ========================================
   4. DIAGRAM CONTAINERS
   ======================================== */

.technical-doc-diagram {
    margin: var(--space-6) 0;
    background: var(--secondary-dark);
    border: 1px solid var(--medium-gray);
    padding: var(--space-5);
    text-align: center;
}

.technical-doc-diagram img,
.technical-doc-diagram svg {
    max-width: 100%;
    height: auto;
}

.technical-doc-diagram__placeholder {
    padding: var(--space-6);
    border: 1px dashed var(--medium-gray);
    background: rgba(255, 255, 255, 0.03);
}

.technical-doc-diagram__alt {
    font-size: var(--text-sm);
    color: var(--light-gray);
    font-style: italic;
    margin: 0;
    line-height: 1.6;
}

.technical-doc-diagram figcaption {
    margin-top: var(--space-3);
    font-size: var(--text-sm);
    color: var(--light-gray);
    font-style: italic;
}

/* ========================================
   5. CALLOUT BOXES
   ======================================== */

.technical-doc-callout {
    margin: var(--space-6) 0;
    padding: var(--space-5);
    background: var(--secondary-dark);
    border: 1px solid var(--medium-gray);
    border-left-width: 4px;
}

.technical-doc-callout p {
    margin: 0;
}

.technical-doc-callout p + p {
    margin-top: var(--space-3);
}

/* Info variant */
.technical-doc-callout--info {
    border-left-color: var(--accent-orange);
}

/* Warning variant */
.technical-doc-callout--warning {
    border-left-color: #f59e0b;
}

/* Note variant */
.technical-doc-callout--note {
    border-left-color: var(--accent-orange);
}

/* ========================================
   6. TABLES — Technical Specs
   ======================================== */

.technical-doc-table-wrapper {
    overflow-x: auto;
    margin: var(--space-6) 0;
    border: 1px solid var(--medium-gray);
    background: var(--secondary-dark);
}

.technical-doc-table {
    width: 100%;
    border-collapse: collapse;
    font-size: var(--text-sm);
    color: var(--light-gray);
}

.technical-doc-table th {
    background: rgba(64, 64, 64, 0.3);
    color: var(--text-white);
    font-weight: var(--font-semibold);
    padding: var(--space-3) var(--space-4);
    text-align: left;
    border-bottom: 2px solid var(--medium-gray);
    font-size: var(--text-sm);
    text-transform: uppercase;
    letter-spacing: 0.05em;
    white-space: nowrap;
}

.technical-doc-table td {
    padding: var(--space-3) var(--space-4);
    border-bottom: 1px solid var(--medium-gray);
    vertical-align: top;
    line-height: 1.6;
}

.technical-doc-table tr:last-child td {
    border-bottom: none;
}

.technical-doc-table tr:hover {
    background: rgba(64, 64, 64, 0.2);
}

/* ========================================
   7. CODE BLOCKS
   ======================================== */

.technical-doc-code {
    margin: var(--space-5) 0;
    background: var(--secondary-dark);
    border: 1px solid var(--medium-gray);
    border-left-width: 3px;
    border-left-color: var(--accent-orange);
    overflow-x: auto;
}

.technical-doc-code__header {
    display: flex;
    align-items: center;
    padding: var(--space-2) var(--space-4);
    background: rgba(64, 64, 64, 0.3);
    border-bottom: 1px solid var(--medium-gray);
    font-size: var(--text-xs);
    font-weight: var(--font-medium);
    color: var(--accent-orange);
    text-transform: uppercase;
    letter-spacing: 0.05em;
}

.technical-doc-code pre {
    margin: 0;
    padding: var(--space-4);
    font-family: var(--font-mono);
    font-size: var(--text-sm);
    color: var(--text-primary-gray);
    line-height: 1.6;
    overflow-x: auto;
    background: none;
    border: none;
}

.technical-doc-code pre code {
    background: none;
    padding: 0;
    color: inherit;
    border: none;
    font-size: inherit;
}

/* ========================================
   8. PREV/NEXT NAVIGATION
   ======================================== */

.article--technical-doc .article__nav {
    margin-top: var(--space-9);
}

.article--technical-doc .article__nav-link:last-child {
    text-align: right;
    margin-left: auto;
}

/* ========================================
   9. LEFT NAV CLEARANCE
   ======================================== */

/* Override vertical centering — align nav top with main content start */
.solutions-scroll-nav {
    top: 180px;
    transform: none;
}

/* Override animation to remove translateY(-50%) */
@keyframes slideInLeft {
    from {
        opacity: 0;
        transform: translateX(-20px);
    }
    to {
        opacity: 1;
        transform: translateX(0);
    }
}

/* Increase margin to clear longer section labels */
@media (min-width: 1200px) {
    body:has(.solutions-scroll-nav) .main-content {
        margin-left: 380px;
    }
}

@media (min-width: 1440px) {
    body:has(.solutions-scroll-nav) .main-content {
        margin-left: 400px;
    }
}

/* ========================================
   10. RESPONSIVE
   ======================================== */

/* Tablet and below */
@media (max-width: 1023px) {
    .technical-docs-hub {
        padding: var(--space-10) var(--space-5) var(--space-8);
    }

    .technical-docs-hub__title {
        font-size: var(--text-4xl);
    }

    .technical-docs-hub__grid {
        grid-template-columns: repeat(2, 1fr);
    }
}

/* Mobile */
@media (max-width: 767px) {
    .technical-docs-hub {
        padding: var(--space-9) var(--space-4) var(--space-6);
    }

    .technical-docs-hub__title {
        font-size: var(--text-3xl);
    }

    .technical-docs-hub__grid {
        grid-template-columns: 1fr;
    }

    .technical-doc-diagram {
        padding: var(--space-3);
    }

    .technical-doc-table-wrapper {
        font-size: var(--text-xs);
    }

    .technical-doc-table th,
    .technical-doc-table td {
        padding: var(--space-2) var(--space-3);
    }
}

/* Large Desktop */
@media (min-width: 1440px) {
    .technical-docs-hub__grid {
        grid-template-columns: repeat(4, 1fr);
    }
}

/* ========================================
   10. PRINT
   ======================================== */

@media print {
    .technical-doc-diagram {
        background: white;
        border-color: #ccc;
    }

    .technical-doc-callout {
        background: #f5f5f5;
        border-color: #ccc;
    }

    .technical-docs-card {
        background: white;
        border-color: #ccc;
        color: black;
    }
}