/* Docs stylesheet — built on the main site's design tokens.
   tokens / themes / density / shape / accent / base are loaded from ../../css.
   This file adds docs-specific layout: app-bar style header, content shell,
   guide cards, callouts, tables, and prose typography. */

/* ── Shell ───────────────────────────────────────────────────────── */
body {
    min-height: 100vh;
    background: var(--color-bg);
}

.docs-shell {
    min-height: 100vh;
    display: flex;
    flex-direction: column;
}

/* ── Top bar ─────────────────────────────────────────────────────── */
.docs-bar {
    position: sticky;
    top: 0;
    z-index: var(--z-app-bar);
    display: flex;
    align-items: center;
    gap: var(--space-4);
    height: var(--app-bar-height);
    padding: 0 var(--space-6);
    background: var(--color-surface);
    border-bottom: 1px solid var(--color-border);
}

.docs-bar__brand {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    color: var(--color-primary);
    text-decoration: none;
    height: 36px;
}

.docs-bar__brand svg { height: 28px; width: auto; display: block; }

.docs-bar__brand-text {
    display: inline-flex;
    align-items: baseline;
    gap: var(--space-2);
    color: var(--color-text);
    font-weight: var(--weight-semibold);
    font-size: var(--text-headline);
    letter-spacing: -0.01em;
}

.docs-bar__brand-text .docs-bar__brand-kicker {
    color: var(--color-text-muted);
    font-size: var(--text-label);
    font-weight: var(--weight-medium);
    text-transform: uppercase;
    letter-spacing: 0.08em;
}

.docs-bar__nav {
    flex: 1 1 auto;
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
    margin-left: var(--space-5);
}

.docs-bar__nav a {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    padding: 0 var(--space-3);
    height: 36px;
    border-radius: var(--radius-button);
    color: var(--color-text-muted);
    font-size: var(--text-body);
    font-weight: var(--weight-medium);
    text-decoration: none;
    transition: background var(--motion-fast) var(--ease-standard),
                color var(--motion-fast) var(--ease-standard);
}
.docs-bar__nav a:hover {
    background: var(--color-surface-tint);
    color: var(--color-text);
    text-decoration: none;
}
.docs-bar__nav a.is-active {
    background: var(--color-primary-container);
    color: var(--color-primary-on-container);
}
.docs-bar__nav .icon { font-size: 18px; }

.docs-bar__actions {
    display: flex;
    align-items: center;
    gap: var(--space-1);
    margin-left: auto;
}

/* ── Main ────────────────────────────────────────────────────────── */
.docs-main {
    flex: 1 1 auto;
    width: 100%;
    max-width: 960px;
    margin: 0 auto;
    padding: var(--space-7) var(--space-6) var(--space-8);
}

/* ── Page header (per-guide hero) ────────────────────────────────── */
.docs-hero {
    margin-bottom: var(--space-7);
}

.docs-hero__eyebrow {
    display: inline-flex;
    align-items: center;
    gap: var(--space-2);
    padding: 4px var(--space-3);
    background: var(--color-primary-container);
    color: var(--color-primary-on-container);
    border-radius: var(--radius-chip);
    font-size: var(--text-label);
    font-weight: var(--weight-semibold);
    text-transform: uppercase;
    letter-spacing: 0.06em;
    margin-bottom: var(--space-3);
}
.docs-hero__eyebrow .icon { font-size: 16px; }

.docs-hero h1 {
    font-size: var(--text-display);
    font-weight: var(--weight-bold);
    letter-spacing: -0.02em;
    margin-bottom: var(--space-3);
}

.docs-hero p {
    font-size: var(--text-headline);
    color: var(--color-text-muted);
    max-width: 64ch;
    line-height: var(--line-snug);
}

/* ── index.html landing cards ────────────────────────────────────── */
.guide-grid {
    display: grid;
    gap: var(--space-4);
    grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
    margin-bottom: var(--space-7);
}

.guide-card {
    display: flex;
    flex-direction: column;
    gap: var(--space-3);
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-card);
    padding: var(--space-5);
    text-decoration: none;
    color: inherit;
    box-shadow: var(--elev-1);
    transition: box-shadow var(--motion-fast) var(--ease-standard),
                transform var(--motion-fast) var(--ease-standard),
                border-color var(--motion-fast) var(--ease-standard);
}
.guide-card:hover {
    text-decoration: none;
    transform: translateY(-2px);
    box-shadow: var(--elev-3);
    border-color: var(--color-border-strong);
}

.guide-card__icon {
    width: 44px;
    height: 44px;
    display: inline-flex;
    align-items: center;
    justify-content: center;
    background: var(--color-primary-container);
    color: var(--color-primary-on-container);
    border-radius: var(--radius-md);
}
.guide-card__icon .icon { font-size: 24px; }

.guide-card h3 {
    font-size: var(--text-headline);
    font-weight: var(--weight-semibold);
    color: var(--color-text);
    margin: 0;
}

.guide-card p {
    color: var(--color-text-muted);
    font-size: var(--text-body);
    margin: 0;
}

.guide-card__cta {
    display: inline-flex;
    align-items: center;
    gap: var(--space-1);
    color: var(--color-primary);
    font-weight: var(--weight-semibold);
    font-size: var(--text-body);
    margin-top: auto;
}
.guide-card__cta .icon { font-size: 18px; }

/* ── Section container (per-guide content) ──────────────────────── */
.docs-section {
    background: var(--color-surface);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-card);
    padding: var(--space-6);
    margin-bottom: var(--space-5);
    box-shadow: var(--elev-1);
}

.docs-section + .docs-section { margin-top: 0; }

.docs-section h2 {
    font-size: var(--text-title);
    font-weight: var(--weight-semibold);
    color: var(--color-text);
    margin-bottom: var(--space-4);
    letter-spacing: -0.01em;
}

.docs-section h3 {
    font-size: var(--text-headline);
    font-weight: var(--weight-semibold);
    color: var(--color-text);
    margin-top: var(--space-5);
    margin-bottom: var(--space-2);
}

.docs-section h3:first-child { margin-top: 0; }

/* ── Prose typography ────────────────────────────────────────────── */
.docs-section p,
.docs-section ul,
.docs-section ol {
    color: var(--color-text);
    font-size: var(--text-body);
    line-height: var(--line-normal);
}

.docs-section p + p,
.docs-section p + ul,
.docs-section p + ol,
.docs-section ul + p,
.docs-section ol + p {
    margin-top: var(--space-3);
}

.docs-section ul,
.docs-section ol {
    margin: var(--space-2) 0 0;
    padding-left: var(--space-5);
}

.docs-section li + li { margin-top: var(--space-1); }
.docs-section li > ul,
.docs-section li > ol { margin-top: var(--space-1); }

.docs-section strong { font-weight: var(--weight-semibold); color: var(--color-text); }
.docs-section em { color: var(--color-text); }

.docs-section a {
    color: var(--color-primary);
    text-decoration: none;
    border-bottom: 1px solid color-mix(in srgb, var(--color-primary) 35%, transparent);
    transition: border-color var(--motion-fast) var(--ease-standard);
}
.docs-section a:hover { border-bottom-color: var(--color-primary); text-decoration: none; }

/* ── Callouts ────────────────────────────────────────────────────── */
.callout {
    display: flex;
    gap: var(--space-3);
    align-items: flex-start;
    border: 1px solid var(--color-border);
    border-left: 4px solid var(--color-info);
    background: color-mix(in srgb, var(--color-info) 8%, var(--color-surface));
    border-radius: var(--radius-md);
    padding: var(--space-3) var(--space-4);
    margin: var(--space-4) 0;
    color: var(--color-text);
    font-size: var(--text-body);
    line-height: var(--line-snug);
}

.callout::before {
    font-family: var(--font-icon);
    font-size: 22px;
    line-height: 1;
    color: var(--color-info);
    flex-shrink: 0;
    margin-top: 1px;
    font-variation-settings: 'FILL' 1, 'wght' 500, 'GRAD' 0, 'opsz' 24;
    content: 'info';
}

.callout.info {
    border-left-color: var(--color-info);
    background: color-mix(in srgb, var(--color-info) 8%, var(--color-surface));
}
.callout.info::before { content: 'info'; color: var(--color-info); }

.callout.warning {
    border-left-color: var(--color-warning);
    background: color-mix(in srgb, var(--color-warning) 10%, var(--color-surface));
}
.callout.warning::before { content: 'warning'; color: var(--color-warning); }

.callout strong { color: var(--color-text); }

/* ── Tables ──────────────────────────────────────────────────────── */
.docs-section table {
    width: 100%;
    border-collapse: separate;
    border-spacing: 0;
    margin: var(--space-4) 0;
    font-size: var(--text-body);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    overflow: hidden;
    background: var(--color-bg-2);
}

.docs-section th,
.docs-section td {
    text-align: left;
    padding: var(--space-3) var(--space-4);
    border-bottom: 1px solid var(--color-border);
}

.docs-section th {
    background: var(--color-surface-2);
    color: var(--color-text-muted);
    font-weight: var(--weight-semibold);
    font-size: var(--text-label);
    text-transform: uppercase;
    letter-spacing: 0.04em;
}

.docs-section tr:last-child td { border-bottom: none; }
.docs-section tbody tr:hover td { background: var(--color-surface-tint); }

/* ── Code blocks ────────────────────────────────────────────────── */
.docs-section pre {
    background: var(--color-bg-2);
    color: var(--color-text);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    padding: var(--space-4);
    overflow-x: auto;
    margin: var(--space-4) 0;
    font-size: 0.875rem;
    line-height: 1.55;
    font-family: var(--font-mono);
}

.docs-section pre code {
    font-family: inherit;
    background: none;
    padding: 0;
    color: inherit;
    border: none;
}

.docs-section code {
    font-family: var(--font-mono);
    font-size: 0.875em;
    background: var(--color-surface-2);
    color: var(--color-text);
    padding: 2px 6px;
    border-radius: var(--radius-xs);
    border: 1px solid var(--color-border);
}

/* ── Footer ──────────────────────────────────────────────────────── */
.docs-footer {
    margin-top: auto;
    padding: var(--space-5) var(--space-6);
    border-top: 1px solid var(--color-border);
    background: var(--color-surface);
    color: var(--color-text-muted);
    font-size: var(--text-caption);
    text-align: center;
}

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

/* ── Welcome (docs index) section ────────────────────────────────── */
.docs-welcome {
    background: linear-gradient(135deg,
        color-mix(in srgb, var(--color-primary) 10%, var(--color-surface)),
        var(--color-surface));
    border: 1px solid var(--color-border);
    border-radius: var(--radius-card);
    padding: var(--space-7) var(--space-6);
    margin-bottom: var(--space-6);
    box-shadow: var(--elev-1);
}

.docs-welcome h2 {
    font-size: var(--text-display);
    font-weight: var(--weight-bold);
    margin-bottom: var(--space-3);
    letter-spacing: -0.02em;
}

.docs-welcome p {
    font-size: var(--text-headline);
    color: var(--color-text-muted);
    max-width: 64ch;
    line-height: var(--line-snug);
}

/* ── Security highlights list (index.html) ───────────────────────── */
.security-list {
    list-style: none;
    padding: 0;
    margin: 0;
    display: grid;
    gap: var(--space-3);
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
}

.security-list li {
    display: flex;
    gap: var(--space-3);
    align-items: flex-start;
    background: var(--color-bg-2);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    padding: var(--space-3) var(--space-4);
    font-size: var(--text-body);
    color: var(--color-text);
}

.security-list li::before {
    font-family: var(--font-icon);
    font-size: 20px;
    line-height: 1;
    color: var(--color-primary);
    font-variation-settings: 'FILL' 1, 'wght' 500, 'GRAD' 0, 'opsz' 24;
    content: 'shield';
    flex-shrink: 0;
    margin-top: 1px;
}

.security-list strong { color: var(--color-text); display: block; margin-bottom: 2px; }

/* ── Responsive ──────────────────────────────────────────────────── */
@media (max-width: 720px) {
    .docs-bar { padding: 0 var(--space-4); gap: var(--space-2); }
    .docs-bar__nav { margin-left: 0; gap: 0; overflow-x: auto; flex-wrap: nowrap; }
    .docs-bar__nav a { padding: 0 var(--space-2); white-space: nowrap; }
    .docs-bar__brand-text .docs-bar__brand-kicker { display: none; }
    .docs-main { padding: var(--space-5) var(--space-4) var(--space-6); }
    .docs-section { padding: var(--space-5) var(--space-4); }
    .docs-hero h1 { font-size: 1.625rem; }
    .docs-welcome { padding: var(--space-6) var(--space-4); }
    .docs-welcome h2 { font-size: 1.625rem; }
}