/**
 * AEOS Glossary — Frontend Stylesheet
 * Covers: single term pages, Knowledge Hub archive, tooltips.
 *
 * Design principles:
 *  - Uses CSS custom properties for easy theming.
 *  - Mobile-first responsive.
 *  - Avoids !important except for accessibility overrides.
 *  - High-contrast compliant (WCAG 2.1 AA).
 *  - Print styles included.
 */

/* ── Custom Properties ───────────────────────────────────────────────────────── */

:root {
    --aeos-primary:          #1a56db;
    --aeos-primary-dark:     #1a3e8c;
    --aeos-primary-light:    #e8f0fe;
    --aeos-accent:           #0e9f6e;
    --aeos-accent-light:     #def7ec;
    --aeos-text:             #111827;
    --aeos-text-secondary:   #4b5563;
    --aeos-text-muted:       #6b7280;
    --aeos-border:           #e5e7eb;
    --aeos-border-strong:    #d1d5db;
    --aeos-bg:               #ffffff;
    --aeos-bg-subtle:        #f9fafb;
    --aeos-bg-code:          #f3f4f6;
    --aeos-snippet-bg:       #eff6ff;
    --aeos-snippet-border:   #3b82f6;
    --aeos-citation-bg:      #fefce8;
    --aeos-citation-border:  #f59e0b;
    --aeos-radius:           6px;
    --aeos-radius-lg:        12px;
    --aeos-shadow-sm:        0 1px 3px rgba(0,0,0,0.08);
    --aeos-shadow:           0 4px 16px rgba(0,0,0,0.10);
    --aeos-shadow-lg:        0 8px 32px rgba(0,0,0,0.14);
    --aeos-transition:       0.18s ease;
    --aeos-font-sans:        -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
    --aeos-font-mono:        'SFMono-Regular', Consolas, 'Liberation Mono', Menlo, monospace;
    --aeos-max-width:        860px;
    --aeos-hub-max-width:    1200px;
}

@media (prefers-color-scheme: dark) {
    :root {
        --aeos-primary:        #60a5fa;
        --aeos-primary-dark:   #93c5fd;
        --aeos-primary-light:  #1e3a5f;
        --aeos-text:           #f3f4f6;
        --aeos-text-secondary: #d1d5db;
        --aeos-text-muted:     #9ca3af;
        --aeos-border:         #374151;
        --aeos-border-strong:  #4b5563;
        --aeos-bg:             #111827;
        --aeos-bg-subtle:      #1f2937;
        --aeos-bg-code:        #1e293b;
        --aeos-snippet-bg:     #1e3a5f;
        --aeos-snippet-border: #3b82f6;
        --aeos-citation-bg:    #2d2a00;
        --aeos-citation-border:#f59e0b;
    }
}

/* ── Wrapper ─────────────────────────────────────────────────────────────────── */

.aeos-glossary-wrap {
    font-family: var(--aeos-font-sans);
    color: var(--aeos-text);
    line-height: 1.7;
}

/* ── Breadcrumb ──────────────────────────────────────────────────────────────── */

.aeos-breadcrumb {
    margin-bottom: 24px;
}

.aeos-breadcrumb__list {
    display: flex;
    flex-wrap: wrap;
    gap: 4px;
    list-style: none;
    margin: 0;
    padding: 0;
    font-size: 13px;
    color: var(--aeos-text-muted);
}

.aeos-breadcrumb__list li:not(:last-child)::after {
    content: '›';
    margin-left: 4px;
}

.aeos-breadcrumb__list a {
    color: var(--aeos-primary);
    text-decoration: none;
}

.aeos-breadcrumb__list a:hover {
    text-decoration: underline;
}

/* ═══════════════════════════════════════════════════════════════════════════════
   SINGLE TERM PAGE
═══════════════════════════════════════════════════════════════════════════════ */

.aeos-term-main {
    max-width: var(--aeos-max-width);
    margin: 0 auto;
    padding: 0 20px 60px;
}

/* ── Term header ─────────────────────────────────────────────────────────────── */

.aeos-term-header {
    margin-bottom: 28px;
    padding-bottom: 20px;
    border-bottom: 2px solid var(--aeos-border);
}

.aeos-term-title {
    font-size: clamp(28px, 4vw, 44px);
    font-weight: 800;
    line-height: 1.15;
    margin: 0 0 12px;
    color: var(--aeos-text);
    letter-spacing: -0.02em;
}

/* dfn — the defining instance of the term */
.aeos-term-title dfn {
    font-style: normal;
}

/* ── AEO Snippet ─────────────────────────────────────────────────────────────── */

/* The hard-coded AEO marker per spec. Never change the class or data-intent. */
.aeo-snippet {
    position: relative;
    background: var(--aeos-snippet-bg);
    border-left: 4px solid var(--aeos-snippet-border);
    border-radius: 0 var(--aeos-radius) var(--aeos-radius) 0;
    padding: 16px 20px;
    margin: 24px 0;
}

.aeo-snippet::before {
    content: 'Definition';
    display: block;
    font-size: 10px;
    font-weight: 700;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--aeos-snippet-border);
    margin-bottom: 8px;
}

.aeo-snippet__text,
.aeo-snippet p {
    margin: 0;
    font-size: 17px;
    line-height: 1.65;
    color: var(--aeos-text);
    font-weight: 450;
}

/* ── Section headings ────────────────────────────────────────────────────────── */

.aeos-section-heading {
    font-size: 20px;
    font-weight: 700;
    color: var(--aeos-text);
    margin: 36px 0 16px;
    padding-bottom: 8px;
    border-bottom: 1px solid var(--aeos-border);
}

/* ── Full definition body ────────────────────────────────────────────────────── */

.aeos-definition-body {
    font-size: 16px;
    color: var(--aeos-text);
}

.aeos-definition-body p {
    margin-bottom: 1em;
}

.aeos-definition-body ul,
.aeos-definition-body ol {
    padding-left: 24px;
    margin-bottom: 1em;
}

.aeos-definition-body li {
    margin-bottom: 0.4em;
}

.aeos-definition-body code {
    font-family: var(--aeos-font-mono);
    font-size: 0.875em;
    background: var(--aeos-bg-code);
    padding: 2px 6px;
    border-radius: 4px;
}

.aeos-definition-body pre {
    background: var(--aeos-bg-code);
    border: 1px solid var(--aeos-border);
    border-radius: var(--aeos-radius);
    padding: 16px 20px;
    overflow-x: auto;
    font-family: var(--aeos-font-mono);
    font-size: 14px;
    line-height: 1.6;
}

.aeos-definition-body blockquote {
    border-left: 4px solid var(--aeos-border-strong);
    margin: 24px 0;
    padding: 12px 20px;
    color: var(--aeos-text-secondary);
    font-style: italic;
}

/* ── Citations (authoritative blockquotes) ────────────────────────────────────── */

.aeos-citations {
    margin: 36px 0;
}

.aeos-citation {
    background: var(--aeos-citation-bg);
    border-left: 4px solid var(--aeos-citation-border);
    border-radius: 0 var(--aeos-radius) var(--aeos-radius) 0;
    padding: 16px 20px;
    margin: 16px 0;
    font-style: italic;
    color: var(--aeos-text);
}

.aeos-citation p {
    margin: 0 0 10px;
    font-size: 15px;
    line-height: 1.65;
}

.aeos-citation footer {
    font-size: 13px;
    font-style: normal;
    color: var(--aeos-text-muted);
}

.aeos-citation footer cite {
    font-style: normal;
    font-weight: 600;
}

.aeos-citation footer a {
    color: var(--aeos-primary);
    text-decoration: none;
}

.aeos-citation footer a:hover {
    text-decoration: underline;
}

/* ── Cluster badges ──────────────────────────────────────────────────────────── */

.aeos-cluster-nav {
    display: flex;
    flex-wrap: wrap;
    align-items: center;
    gap: 8px;
    margin: 24px 0;
}

.aeos-cluster-nav__label {
    font-size: 12px;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.08em;
    color: var(--aeos-text-muted);
}

.aeos-cluster-badge,
.aeos-card__cluster-tag,
.aeos-tooltip-cluster {
    display: inline-flex;
    align-items: center;
    background: var(--aeos-accent-light);
    color: var(--aeos-accent);
    border: 1px solid var(--aeos-accent);
    border-radius: 999px;
    padding: 3px 12px;
    font-size: 12px;
    font-weight: 600;
    text-decoration: none;
    transition: background var(--aeos-transition), color var(--aeos-transition);
}

.aeos-cluster-badge:hover,
.aeos-card__cluster-tag:hover {
    background: var(--aeos-accent);
    color: #fff;
}

.aeos-cluster-badges--header {
    margin-top: 8px;
    display: flex;
    flex-wrap: wrap;
    gap: 6px;
}

/* ── Related terms ───────────────────────────────────────────────────────────── */

.aeos-related-terms-nav {
    margin: 36px 0;
}

.aeos-related-terms {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
    gap: 10px;
}

.aeos-related-term {
    display: flex;
    align-items: center;
    justify-content: space-between;
    background: var(--aeos-bg-subtle);
    border: 1px solid var(--aeos-border);
    border-radius: var(--aeos-radius);
    padding: 10px 14px;
    transition: border-color var(--aeos-transition), box-shadow var(--aeos-transition);
}

.aeos-related-term:hover {
    border-color: var(--aeos-primary);
    box-shadow: var(--aeos-shadow-sm);
}

.aeos-related-term__link {
    color: var(--aeos-primary);
    text-decoration: none;
    font-weight: 600;
    font-size: 14px;
}

.aeos-related-term__link:hover {
    text-decoration: underline;
}

.aeos-related-term__type {
    font-size: 11px;
    color: var(--aeos-text-muted);
    white-space: nowrap;
}

/* ── Term footer / metadata ──────────────────────────────────────────────────── */

.aeos-term-footer {
    margin-top: 48px;
    padding-top: 20px;
    border-top: 1px solid var(--aeos-border);
}

.aeos-term-meta {
    display: grid;
    grid-template-columns: max-content 1fr;
    gap: 6px 16px;
    font-size: 13px;
    margin: 0;
}

.aeos-term-meta dt {
    color: var(--aeos-text-muted);
    font-weight: 600;
}

.aeos-term-meta dd {
    margin: 0;
    color: var(--aeos-text);
}

.aeos-entity-id {
    font-family: var(--aeos-font-mono);
    font-size: 12px;
    background: var(--aeos-bg-code);
    padding: 2px 6px;
    border-radius: 4px;
}

.aeos-term-permalink {
    color: var(--aeos-primary);
    text-decoration: none;
    font-size: 12px;
    word-break: break-all;
}

/* ═══════════════════════════════════════════════════════════════════════════════
   KNOWLEDGE HUB ARCHIVE
═══════════════════════════════════════════════════════════════════════════════ */

.aeos-hub-main {
    max-width: var(--aeos-hub-max-width);
    margin: 0 auto;
    padding: 0 20px 80px;
}

/* ── Hub header ──────────────────────────────────────────────────────────────── */

.aeos-hub-header {
    margin-bottom: 32px;
}

.aeos-hub-title-row {
    margin-bottom: 20px;
}

.aeos-hub-title {
    font-size: clamp(28px, 4vw, 48px);
    font-weight: 900;
    margin: 0 0 8px;
    letter-spacing: -0.025em;
    color: var(--aeos-text);
}

.aeos-hub-subtitle {
    font-size: 16px;
    color: var(--aeos-text-secondary);
    margin: 0;
}

/* ── Cluster tabs ────────────────────────────────────────────────────────────── */

.aeos-hub-tabs {
    display: flex;
    flex-wrap: wrap;
    gap: 6px;
    padding-bottom: 2px;
    border-bottom: 2px solid var(--aeos-border);
    margin-bottom: 24px;
}

.aeos-hub-tab {
    display: inline-flex;
    align-items: center;
    gap: 6px;
    padding: 6px 16px;
    border-radius: var(--aeos-radius) var(--aeos-radius) 0 0;
    font-size: 14px;
    font-weight: 600;
    color: var(--aeos-text-secondary);
    text-decoration: none;
    border: 1px solid transparent;
    border-bottom: 2px solid transparent;
    margin-bottom: -2px;
    transition: color var(--aeos-transition), border-color var(--aeos-transition);
}

.aeos-hub-tab:hover {
    color: var(--aeos-primary);
    background: var(--aeos-primary-light);
}

.aeos-hub-tab--active {
    color: var(--aeos-primary);
    background: var(--aeos-bg);
    border-color: var(--aeos-border);
    border-bottom-color: var(--aeos-bg);
}

.aeos-tab-count {
    font-size: 11px;
    font-weight: 400;
    color: var(--aeos-text-muted);
}

/* ── Search bar ──────────────────────────────────────────────────────────────── */

.aeos-hub-search {
    position: relative;
    margin-bottom: 32px;
}

.aeos-hub-search__input {
    width: 100%;
    max-width: 480px;
    padding: 10px 40px 10px 16px;
    border: 2px solid var(--aeos-border);
    border-radius: var(--aeos-radius);
    font-size: 15px;
    color: var(--aeos-text);
    background: var(--aeos-bg);
    outline: none;
    transition: border-color var(--aeos-transition), box-shadow var(--aeos-transition);
    box-sizing: border-box;
}

.aeos-hub-search__input:focus {
    border-color: var(--aeos-primary);
    box-shadow: 0 0 0 3px rgba(26, 86, 219, 0.12);
}

.aeos-hub-search__icon {
    position: absolute;
    right: max(calc(100% - 440px), 12px);
    top: 50%;
    transform: translateY(-50%);
    color: var(--aeos-text-muted);
    pointer-events: none;
}

.aeos-hub-search__count {
    display: block;
    margin-top: 8px;
    font-size: 13px;
    color: var(--aeos-text-muted);
    min-height: 18px;
}

/* ── Cluster sections ────────────────────────────────────────────────────────── */

.aeos-hub-cluster {
    margin-bottom: 56px;
    scroll-margin-top: 80px;
}

.aeos-hub-cluster__header {
    display: flex;
    align-items: baseline;
    flex-wrap: wrap;
    gap: 12px;
    margin-bottom: 20px;
    padding-bottom: 12px;
    border-bottom: 2px solid var(--aeos-border);
}

.aeos-hub-cluster__title {
    font-size: 22px;
    font-weight: 800;
    margin: 0;
    color: var(--aeos-text);
    flex: 1 1 auto;
}

.aeos-hub-cluster__desc {
    width: 100%;
    font-size: 14px;
    color: var(--aeos-text-secondary);
    margin: 0;
}

.aeos-hub-cluster__count {
    font-size: 12px;
    color: var(--aeos-text-muted);
    font-weight: 500;
    white-space: nowrap;
}

/* ── Term card grid ──────────────────────────────────────────────────────────── */

.aeos-hub-grid {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
    gap: 16px;
}

/* ── Individual hub card ─────────────────────────────────────────────────────── */

.aeos-hub-card {
    border: 1px solid var(--aeos-border);
    border-radius: var(--aeos-radius-lg);
    overflow: hidden;
    background: var(--aeos-bg);
    transition: box-shadow var(--aeos-transition), border-color var(--aeos-transition), transform var(--aeos-transition);
}

.aeos-hub-card:hover {
    box-shadow: var(--aeos-shadow);
    border-color: var(--aeos-primary);
    transform: translateY(-2px);
}

.aeos-hub-card[hidden] {
    display: none !important;
}

.aeos-hub-card__link {
    display: block;
    padding: 20px;
    text-decoration: none;
    color: var(--aeos-text);
    height: 100%;
    box-sizing: border-box;
}

.aeos-hub-card__title {
    font-size: 16px;
    font-weight: 700;
    margin: 0 0 10px;
    color: var(--aeos-text);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 8px;
}

.aeos-hub-card__link:hover .aeos-hub-card__title span {
    color: var(--aeos-primary);
}

/* AEO snippet inside card — same hard-coded class, lighter styling in this context. */
.aeos-hub-card .aeo-snippet {
    background: transparent;
    border-left: 3px solid var(--aeos-snippet-border);
    padding: 8px 12px;
    margin: 0 0 12px;
    border-radius: 0 4px 4px 0;
}

.aeos-hub-card .aeo-snippet::before {
    display: none;
}

.aeos-hub-card .aeo-snippet p {
    font-size: 13px;
    color: var(--aeos-text-secondary);
    line-height: 1.55;
    display: -webkit-box;
    -webkit-line-clamp: 3;
    -webkit-box-orient: vertical;
    overflow: hidden;
}

.aeos-card__related-badge {
    display: inline-flex;
    align-items: center;
    justify-content: center;
    min-width: 20px;
    height: 20px;
    background: var(--aeos-primary-light);
    color: var(--aeos-primary);
    border-radius: 999px;
    font-size: 11px;
    font-weight: 700;
    padding: 0 5px;
    flex-shrink: 0;
}

.aeos-card__clusters {
    display: flex;
    flex-wrap: wrap;
    gap: 4px;
    margin-top: 8px;
}

.aeos-card__cluster-tag {
    font-size: 11px;
    padding: 2px 8px;
}

/* ── Empty state ─────────────────────────────────────────────────────────────── */

.aeos-hub-empty {
    text-align: center;
    padding: 48px 20px;
    color: var(--aeos-text-muted);
    font-size: 16px;
}

/* ── Hub unclustered ─────────────────────────────────────────────────────────── */

.aeos-hub-cluster--unclustered .aeos-hub-cluster__title {
    color: var(--aeos-text-muted);
    font-style: italic;
}

/* ═══════════════════════════════════════════════════════════════════════════════
   RESPONSIVE
═══════════════════════════════════════════════════════════════════════════════ */

@media (max-width: 768px) {
    .aeos-hub-tabs {
        overflow-x: auto;
        flex-wrap: nowrap;
        -webkit-overflow-scrolling: touch;
        scrollbar-width: none;
    }

    .aeos-hub-tabs::-webkit-scrollbar {
        display: none;
    }

    .aeos-hub-grid {
        grid-template-columns: 1fr;
    }

    .aeos-related-terms {
        grid-template-columns: 1fr;
    }

    .aeos-term-meta {
        grid-template-columns: 1fr;
    }
}

/* ═══════════════════════════════════════════════════════════════════════════════
   PRINT
═══════════════════════════════════════════════════════════════════════════════ */

@media print {
    .aeos-hub-tabs,
    .aeos-hub-search,
    .aeos-cluster-nav,
    .aeos-tooltip-region,
    .aeos-breadcrumb {
        display: none !important;
    }

    .aeo-snippet {
        background: #f9f9f9;
        border-left: 4px solid #000;
    }

    .aeos-hub-card {
        break-inside: avoid;
        border: 1px solid #ccc;
    }

    .aeos-term-link::after {
        content: ' (' attr(href) ')';
        font-size: 0.8em;
        color: #555;
    }
}