/* ==========================================================================
   guide.css — shared stylesheet for the writer guides (public/admin/guides/)

   Layers, in order:
     1. :root token block — brand tokens copied from
        docs/reference/BRAND-STYLE-GUIDE.md §13 (the source of truth; if the
        brand guide changes, update this block to match), plus guide-local
        tokens (alert tones, chrome) — no hex values appear outside :root
        except the print block.
     2. Guide base styles (header, content, sections, tables, callouts, FAQ).
     3. Nav / TOC chrome built by guide-nav.js (top bar, sidebar, drawer).
   ========================================================================== */

:root {
    /* Brand tokens — BRAND-STYLE-GUIDE.md §13 */
    --color-primary: #ff6600;
    --color-primary-dark: #e65c00;
    --color-dark: #212529;
    --color-dark-light: #343a40;
    --color-dark-medium: #495057;
    --color-light: #ffffff;
    --color-light-gray: #f8f9fa;
    --color-text-light: #d4d8dc;
    --color-text-dark: #5a6268;
    --color-border: #e9ecef;
    --color-border-dark: #dee2e6;

    --font-primary: 'Montserrat', -apple-system, BlinkMacSystemFont, sans-serif;
    --font-secondary: 'Roboto', -apple-system, BlinkMacSystemFont, sans-serif;
    --font-mono: 'SF Mono', 'Fira Code', monospace;

    --radius-xs: 4px;
    --radius-sm: 6px;
    --radius-md: 12px;

    --space-1: 4px;
    --space-2: 8px;
    --space-3: 12px;
    --space-4: 16px;
    --space-5: 20px;
    --space-6: 24px;
    --space-8: 32px;
    --space-10: 40px;
    --space-12: 48px;
    --space-16: 64px;

    --container-text: 800px;
    --focus-ring: 0 0 0 3px rgba(255, 102, 0, 0.35);

    /* Guide-local tokens (the brand palette has no alert tones) */
    --note-bg: #fff7ed;
    --note-border: #fed7aa;
    --warn-bg: #fef2f2;
    --warn-border: #fecaca;
    --warn-accent: #dc2626;
    --shadow-sticky: 0 2px 10px rgba(0, 0, 0, 0.08);
    --shadow-drawer: 0 16px 40px rgba(0, 0, 0, 0.18);
    --backdrop: rgba(0, 0, 0, 0.4);
    --topbar-height: 60px;
}

/* ==========================================================================
   2. Guide base
   ========================================================================== */

*, *::before, *::after {
    box-sizing: border-box;
    margin: 0;
    padding: 0;
}

@media (prefers-reduced-motion: no-preference) {
    html {
        scroll-behavior: smooth;
    }
}

body {
    font-family: var(--font-secondary);
    background: var(--color-light-gray);
    color: var(--color-dark);
    line-height: 1.7;
    min-height: 100vh;
}

:focus-visible {
    outline: 2px solid var(--color-primary);
    outline-offset: 2px;
    border-radius: var(--radius-xs);
}

:focus:not(:focus-visible) {
    outline: none;
}

.guide-header {
    background: var(--color-dark);
    color: var(--color-text-light);
    padding: var(--space-8) var(--space-6);
    text-align: center;
}

.guide-header img {
    height: 48px;
    margin-bottom: var(--space-4);
}

.guide-header h1 {
    font-family: var(--font-primary);
    font-size: 1.5rem;
    font-weight: 800;
    color: var(--color-light);
    margin-bottom: var(--space-1);
}

.guide-header p {
    color: var(--color-text-light);
    font-size: 0.95rem;
}

.guide-content {
    max-width: var(--container-text);
    margin: 0 auto;
    padding: var(--space-8) var(--space-6) var(--space-16);
}

.guide-content section {
    background: var(--color-light);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    padding: var(--space-6) var(--space-8);
    margin-bottom: var(--space-6);
    scroll-margin-top: calc(var(--topbar-height) + var(--space-4));
}

.guide-content h2 {
    font-family: var(--font-primary);
    font-size: 1.15rem;
    font-weight: 800;
    margin-bottom: 1rem;
    color: var(--color-dark);
    padding-bottom: 0.5rem;
    border-bottom: 2px solid var(--color-primary);
}

.guide-content h2 code {
    font-size: 1rem;
}

.guide-content h3 {
    font-family: var(--font-primary);
    font-size: 1rem;
    font-weight: 700;
    margin: 1rem 0 0.5rem;
}

.guide-content p {
    margin-bottom: 0.75rem;
    font-size: 0.95rem;
}

.guide-content ul, .guide-content ol {
    margin: 0.5rem 0 1rem 1.25rem;
    font-size: 0.95rem;
}

.guide-content li {
    margin-bottom: 0.4rem;
}

.guide-content strong {
    color: var(--color-dark);
}

table.guide-table {
    width: 100%;
    border-collapse: collapse;
    margin: 0.75rem 0 1rem;
    font-size: 0.9rem;
}

table.guide-table th,
table.guide-table td {
    text-align: left;
    padding: 0.6rem 0.75rem;
    border: 1px solid var(--color-border);
}

table.guide-table th {
    background: var(--color-light-gray);
    font-weight: 700;
    font-size: 0.85rem;
    text-transform: uppercase;
    letter-spacing: 0.03em;
    color: var(--color-text-dark);
}

.tag {
    display: inline-block;
    background: var(--color-light-gray);
    border: 1px solid var(--color-border-dark);
    border-radius: var(--radius-xs);
    padding: 2px 8px;
    font-size: 0.8rem;
    font-family: var(--font-mono);
    margin: 2px;
    color: var(--color-primary-dark);
}

.tags-container {
    display: flex;
    flex-wrap: wrap;
    gap: var(--space-1);
    margin-top: 0.5rem;
}

code {
    background: var(--color-light-gray);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-xs);
    padding: 1px 6px;
    font-size: 0.85rem;
    font-family: var(--font-mono);
    color: var(--color-primary-dark);
}

.example-block {
    background: var(--color-light-gray);
    border-left: 3px solid var(--color-primary);
    border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
    padding: 1rem 1.25rem;
    margin: 0.75rem 0;
    font-size: 0.9rem;
    line-height: 1.6;
}

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

.checklist li {
    position: relative;
    padding-left: 1.75rem;
    margin-bottom: 0.5rem;
}

.checklist li::before {
    content: '';
    position: absolute;
    left: 0;
    top: 4px;
    width: 16px;
    height: 16px;
    border: 2px solid var(--color-border-dark);
    border-radius: var(--radius-xs);
    background: var(--color-light);
}

.highlight {
    background: var(--note-bg);
    border: 1px solid var(--note-border);
    border-radius: var(--radius-sm);
    padding: 0.75rem 1rem;
    margin: 0.75rem 0;
    font-size: 0.9rem;
}

.warn {
    background: var(--warn-bg);
    border: 1px solid var(--warn-border);
    border-left: 3px solid var(--warn-accent);
    border-radius: var(--radius-sm);
    padding: 0.75rem 1rem;
    margin: 0.75rem 0;
    font-size: 0.9rem;
}

/* FAQ accordion (panel guide) */
.faq-item {
    background: var(--color-light);
    border: 1px solid var(--color-border);
    border-radius: var(--radius-md);
    margin: var(--space-3) 0;
}

.faq-item summary {
    display: flex;
    align-items: baseline;
    gap: var(--space-3);
    font-family: var(--font-primary);
    font-weight: 700;
    font-size: 0.9rem;
    padding: var(--space-3) var(--space-4);
    border-radius: var(--radius-md);
    cursor: pointer;
    list-style: none;
}

.faq-item summary::-webkit-details-marker {
    display: none;
}

.faq-item summary::before {
    content: '';
    flex: none;
    width: 8px;
    height: 8px;
    margin-top: 2px;
    border-right: 2px solid var(--color-primary);
    border-bottom: 2px solid var(--color-primary);
    transform: rotate(-45deg);
    transition: transform 0.2s ease;
}

.faq-item[open] > summary::before {
    transform: rotate(45deg);
}

.faq-item p {
    padding: 0 var(--space-4) var(--space-3) calc(var(--space-4) + 8px + var(--space-3));
    margin-bottom: 0;
    font-size: 0.9rem;
}

/* ==========================================================================
   3. Nav / TOC chrome (elements built by guide-nav.js)
   ========================================================================== */

.skip-link {
    position: fixed;
    top: var(--space-2);
    left: var(--space-2);
    z-index: 30;
    background: var(--color-dark);
    color: var(--color-light);
    font-family: var(--font-primary);
    font-weight: 700;
    font-size: 0.85rem;
    text-decoration: none;
    padding: var(--space-2) var(--space-4);
    border-radius: var(--radius-sm);
    transform: translateY(calc(-100% - var(--space-4)));
}

.skip-link:focus {
    transform: none;
}

.guide-nav {
    position: sticky;
    top: 0;
    z-index: 10;
    display: flex;
    align-items: center;
    gap: var(--space-4);
    background: var(--color-light);
    border-bottom: 1px solid var(--color-border);
    padding: var(--space-3) var(--space-6);
    box-shadow: var(--shadow-sticky);
    font-family: var(--font-primary);
}

.guide-nav a {
    text-decoration: none;
    font-size: 0.85rem;
    font-weight: 700;
    transition: color 0.2s ease;
}

.guide-nav__links {
    display: flex;
    align-items: center;
    gap: var(--space-4);
    margin: 0 auto;
}

.guide-nav__links a {
    color: var(--color-text-dark);
    padding: var(--space-1) 0;
    border-bottom: 2px solid transparent;
}

.guide-nav__links a:hover {
    color: var(--color-primary-dark);
}

.guide-nav__links a[aria-current="page"] {
    color: var(--color-primary);
    border-bottom-color: var(--color-primary);
}

.guide-nav__toggle {
    display: none;
    font-family: var(--font-primary);
    font-weight: 700;
    font-size: 0.85rem;
    color: var(--color-dark);
    background: var(--color-light);
    border: 1px solid var(--color-border-dark);
    border-radius: var(--radius-sm);
    padding: var(--space-2) var(--space-3);
    cursor: pointer;
    white-space: nowrap;
    transition: border-color 0.2s ease, color 0.2s ease;
}

.guide-nav__toggle:hover {
    border-color: var(--color-primary);
    color: var(--color-primary-dark);
}

.guide-nav__toggle[aria-expanded="true"] {
    border-color: var(--color-primary);
    color: var(--color-primary);
}

.guide-nav a:focus-visible,
.guide-nav__toggle:focus-visible,
.guide-toc__link:focus-visible {
    box-shadow: var(--focus-ring);
}

.guide-toc {
    font-family: var(--font-primary);
}

.guide-toc__title {
    font-size: 0.75rem;
    font-weight: 700;
    text-transform: uppercase;
    letter-spacing: 0.12em;
    color: var(--color-primary);
    padding: 0 var(--space-3);
    margin-bottom: var(--space-2);
}

.guide-toc ol {
    list-style: none;
}

.guide-toc__link {
    display: block;
    padding: var(--space-1) var(--space-3);
    border-left: 2px solid transparent;
    color: var(--color-text-dark);
    font-size: 0.8rem;
    font-weight: 700;
    text-decoration: none;
    transition: color 0.2s ease, border-color 0.2s ease;
}

.guide-toc__link:hover {
    color: var(--color-primary-dark);
}

.guide-toc__link[aria-current="true"] {
    color: var(--color-primary);
    border-left-color: var(--color-primary);
}

.guide-toc-backdrop {
    position: fixed;
    inset: 0;
    z-index: 20;
    background: var(--backdrop);
}

.guide-toc-backdrop[hidden] {
    display: none;
}

/* Wide viewports: sticky sidebar beside the content column */
@media (min-width: 1100px) {
    .guide-layout {
        display: grid;
        grid-template-columns: 220px minmax(0, var(--container-text));
        gap: var(--space-8);
        justify-content: center;
        padding: 0 var(--space-5);
    }

    .guide-toc {
        position: sticky;
        top: calc(var(--topbar-height) + var(--space-6));
        align-self: start;
        max-height: calc(100vh - var(--topbar-height) - var(--space-12));
        overflow-y: auto;
        margin-top: var(--space-8);
        padding: var(--space-2) 0;
    }

    .guide-toc-backdrop {
        display: none;
    }
}

/* Narrow viewports: TOC becomes a drawer behind the "Contenido" toggle */
@media (max-width: 1099px) {
    .guide-nav__toggle {
        display: inline-block;
    }

    .guide-toc {
        position: fixed;
        top: 0;
        bottom: 0;
        left: 0;
        z-index: 25;
        width: min(300px, 85vw);
        background: var(--color-light);
        border-right: 1px solid var(--color-border);
        box-shadow: var(--shadow-drawer);
        padding: var(--space-6) var(--space-4);
        overflow-y: auto;
        visibility: hidden;
        transform: translateX(-105%);
        transition: transform 0.2s ease, visibility 0s linear 0.2s;
    }

    .guide-toc.is-open {
        visibility: visible;
        transform: none;
        transition: transform 0.2s ease;
    }
}

@media (max-width: 640px) {
    .guide-nav {
        gap: var(--space-3);
        padding: var(--space-3) var(--space-4);
        overflow-x: auto;
    }

    .guide-content section {
        padding: var(--space-5) var(--space-4);
    }

    table.guide-table {
        font-size: 0.8rem;
    }

    table.guide-table th,
    table.guide-table td {
        padding: 0.4rem 0.5rem;
    }
}

@media (prefers-reduced-motion: reduce) {
    *, *::before, *::after {
        animation-duration: 0.01ms !important;
        animation-iteration-count: 1 !important;
        transition-duration: 0.01ms !important;
        transition-delay: 0s !important;
    }

    html {
        scroll-behavior: auto;
    }
}

@media print {
    .skip-link, .guide-nav, .guide-toc, .guide-toc-backdrop { display: none !important; }
    .guide-header { background: #fff; color: #000; border-bottom: 2px solid #000; }
    .guide-header h1 { color: #000; }
    .guide-header p { color: #666; }
    .guide-content section { border: 1px solid #ddd; break-inside: avoid; }
    body { background: #fff; }
}