/* ==========================================================================
   Destination Tools — Developer Docs / Help Center
   Extends the marketing brand tokens (loaded via /home/css/brand.css).
   Layout: fixed top nav + left sidebar + content column.
   Palette: green primary, deep-navy ink, amber highlight.
   ========================================================================== */

:root {
    --docs-red: #12B76A;         /* primary accent (green) */
    --docs-red-dark: #0B7D48;
    --docs-red-tint: #EAF8F0;
    --docs-green: #0E9E5B;       /* success / positive */
    --docs-green-dark: #0B7D48;
    --docs-green-tint: #EAF8F0;
    --docs-gold: #F5A524;        /* amber highlight */
    --docs-gold-tint: #FEF3E0;
    --docs-ink: #0E1B2A;         /* deep midnight navy */
    --docs-canvas: #F7F9FB;
    --docs-surface: #ffffff;
    --docs-border: #E6EAF0;
    --docs-border-strong: #D3DAE4;
    --docs-muted: #5B6B7C;
    --docs-muted-soft: #8393A3;
    --docs-font-display: "Outfit", system-ui, -apple-system, sans-serif;
    --docs-font-body: "Inter", system-ui, -apple-system, sans-serif;
    --docs-font-mono: "IBM Plex Mono", "SF Mono", ui-monospace, Menlo, Consolas, monospace;
    --docs-sidebar-w: 264px;
    --docs-nav-h: 64px;
    --docs-content-max: 860px;
    --docs-rail-w: 400px;      /* Stripe-style right code rail on guide pages */
    --docs-split-max: 1200px;  /* wider content cap when the code rail is shown */
}

* { box-sizing: border-box; }

html { scroll-behavior: smooth; }

body.docs {
    margin: 0;
    background: var(--docs-canvas);
    color: var(--docs-ink);
    font-family: var(--docs-font-body);
    font-size: 16px;
    line-height: 1.65;
    -webkit-font-smoothing: antialiased;
}

/* ---------- Top nav ---------- */
.docs-nav {
    position: sticky;
    top: 0;
    z-index: 40;
    height: var(--docs-nav-h);
    display: flex;
    align-items: center;
    gap: 20px;
    /* Keep the bar background/border full-width, but align its contents to the
       same 1320px container as the shell below. */
    padding: 0 max(24px, calc((100% - 1320px) / 2));
    background: rgba(255, 255, 255, 0.92);
    backdrop-filter: saturate(180%) blur(10px);
    border-bottom: 1px solid var(--docs-border);
}
.docs-nav__logo { display: flex; align-items: center; }
.docs-nav__logo img { height: 26px; width: auto; display: block; }
.docs-nav__badge {
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    letter-spacing: .04em;
    text-transform: uppercase;
    /* Green accent across the docs (matches the Help Center); brand red stays on the logo only. */
    color: var(--docs-green-dark);
    background: var(--docs-green-tint);
    border-radius: 999px;
    padding: 3px 9px;
    margin-left: 2px;
}
.docs-nav__spacer { flex: 1; }
.docs-nav__links { display: flex; gap: 22px; align-items: center; }
.docs-nav__links a {
    color: var(--docs-muted);
    text-decoration: none;
    font-weight: 500;
    font-size: 14.5px;
}
.docs-nav__links a:hover { color: var(--docs-ink); }
.docs-nav__cta {
    font-family: var(--docs-font-display);
    font-weight: 600;
    font-size: 14px;
    color: #fff !important;
    background: var(--docs-green);
    padding: 9px 16px;
    border-radius: 10px;
    text-decoration: none;
}
.docs-nav__cta:hover { background: #0C6E40; }
.docs-nav__toggle {
    display: none;
    background: none; border: 0; cursor: pointer;
    color: var(--docs-ink); font-size: 26px; line-height: 1;
}

/* ---------- Shell ---------- */
.docs-shell {
    display: grid;
    grid-template-columns: var(--docs-sidebar-w) minmax(0, 1fr);
    align-items: start;
    max-width: 1320px;
    margin: 0 auto;
}
.docs-shell--full {
    grid-template-columns: minmax(0, 1fr);
    max-width: none;
}
.docs-main--full { padding: 0; }

/* ---------- Sidebar ---------- */
.docs-sidebar {
    position: sticky;
    top: var(--docs-nav-h);
    align-self: start;
    height: calc(100vh - var(--docs-nav-h));
    overflow-y: auto;
    padding: 28px 16px 60px 24px;
    border-right: 1px solid var(--docs-border);
}
.docs-sidebar__group { margin-bottom: 26px; }
.docs-sidebar__title {
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    letter-spacing: .08em;
    text-transform: uppercase;
    color: var(--docs-muted-soft);
    margin: 0 0 8px 8px;
}
.docs-sidebar__list { list-style: none; margin: 0; padding: 0; }
.docs-sidebar__list a {
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 8px;
    padding: 6px 8px;
    border-radius: 8px;
    color: var(--docs-muted);
    text-decoration: none;
    font-size: 14.5px;
    font-weight: 500;
}
.docs-sidebar__list a:hover { background: var(--docs-canvas); color: var(--docs-ink); }
.docs-sidebar__list a.is-active {
    background: var(--docs-green-tint);
    color: var(--docs-green-dark);
    font-weight: 600;
}

/* ---------- Content ---------- */
.docs-main { padding: 44px 40px 100px; min-width: 0; }
.docs-content { max-width: var(--docs-content-max); margin: 0 auto; }
.docs-content h1 {
    font-family: var(--docs-font-display);
    font-weight: 800;
    font-size: 2.35rem;
    line-height: 1.12;
    letter-spacing: -0.02em;
    margin: 0 0 10px;
}
.docs-content h2 {
    font-family: var(--docs-font-display);
    font-weight: 700;
    font-size: 1.5rem;
    letter-spacing: -0.01em;
    margin: 44px 0 12px;
    padding-top: 8px;
}
.docs-content h3 {
    font-family: var(--docs-font-display);
    font-weight: 600;
    font-size: 1.15rem;
    margin: 30px 0 8px;
}
.docs-content p, .docs-content li { color: #33332E; }
.docs-content a { color: var(--docs-green); text-decoration: none; font-weight: 500; }
.docs-content a:hover { text-decoration: underline; }
.docs-lede { font-size: 1.15rem; color: var(--docs-muted); margin: 0 0 8px; }

/* ---------- Code ---------- */
.docs-content code {
    font-family: var(--docs-font-mono);
    font-size: 0.86em;
    background: var(--docs-green-tint);
    color: var(--docs-green-dark);
    padding: 2px 6px;
    border-radius: 6px;
}
.docs-content pre {
    background: var(--docs-ink);
    color: #F3F1EE;
    border-radius: 14px;
    padding: 18px 20px;
    overflow-x: auto;
    font-family: var(--docs-font-mono);
    font-size: 13.5px;
    line-height: 1.6;
    margin: 18px 0;
}
.docs-content pre code { background: none; color: inherit; padding: 0; font-size: inherit; }

/* ==========================================================================
   Guide split layout — Stripe-style prose (left) + sticky code rail (right)
   Opt-in via $layout='guide' (adds .docs-main--split). Guide sections wrap
   their prose + code in a .docs-block; plain children stay full-width.
   ========================================================================== */
.docs-main--split { padding: 48px 52px 120px; }
.docs-main--split .docs-content { max-width: var(--docs-split-max); }

.docs-block {
    display: grid;
    grid-template-columns: minmax(0, 1fr) var(--docs-rail-w);
    gap: 48px;
    align-items: start;
    padding: 40px 0;
    border-top: 1px solid var(--docs-border);
}
.docs-block:first-child { border-top: 0; padding-top: 4px; }
.docs-block__prose { min-width: 0; }
.docs-block__prose > :first-child { margin-top: 0; }
.docs-block__prose h2 { margin-top: 0; }
.docs-block__code { position: sticky; top: calc(var(--docs-nav-h) + 24px); min-width: 0; }
.docs-block__code pre { margin: 0; }
/* Full-width section (wide tables, dividers) — spans both tracks. */
.docs-block--full { display: block; padding: 34px 0; }
.docs-block--full .docs-block__prose { max-width: 100%; }

/* Language tabs for a code sample (curl / Node / …) */
.docs-tabs__nav {
    display: flex;
    gap: 6px;
    margin-bottom: 10px;
    flex-wrap: wrap;
}
.docs-tabs__btn {
    font-family: var(--docs-font-mono);
    font-size: 12px;
    font-weight: 500;
    padding: 5px 11px;
    border-radius: 8px;
    border: 1px solid var(--docs-border);
    background: var(--docs-surface);
    color: var(--docs-muted);
    cursor: pointer;
    transition: background .15s ease, color .15s ease;
}
.docs-tabs__btn:hover { color: var(--docs-ink); }
.docs-tabs__btn.is-active {
    background: var(--docs-ink);
    color: #F3F1EE;
    border-color: var(--docs-ink);
}
.docs-tabs__panel { display: none; }
.docs-tabs__panel.is-active { display: block; }
/* Optional caption above a code block in the rail. */
.docs-block__code-label {
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    letter-spacing: .04em;
    text-transform: uppercase;
    color: var(--docs-muted-soft);
    margin: 0 0 8px 2px;
}

/* ---------- Method + status pills ---------- */
.pill {
    display: inline-block;
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    letter-spacing: .03em;
    padding: 2px 8px;
    border-radius: 6px;
    text-transform: uppercase;
    vertical-align: middle;
}
.pill--get    { background: var(--docs-green-tint); color: #0C6E40; }
.pill--post   { background: #E9F0FF; color: #1F4FBF; }
.pill--patch  { background: var(--docs-gold-tint); color: #8A6D00; }
.pill--put    { background: var(--docs-gold-tint); color: #8A6D00; }
.pill--delete { background: var(--docs-red-tint); color: var(--docs-red-dark); }

.status {
    display: inline-block;
    font-family: var(--docs-font-mono);
    font-size: 10.5px;
    font-weight: 600;
    letter-spacing: .05em;
    text-transform: uppercase;
    padding: 2px 7px;
    border-radius: 999px;
}
.status--live      { background: var(--docs-green-tint); color: #0C6E40; }
.status--beta      { background: var(--docs-gold-tint); color: #8A6D00; }
.status--planned   { background: #EFEDEA; color: var(--docs-muted); }
.status--next      { background: var(--docs-green-tint); color: #0C6E40; }
.status--exploring { background: #E9F0FF; color: #1F4FBF; }

/* ---------- Tables ---------- */
.docs-table-wrap { overflow-x: auto; margin: 18px 0; }
.docs-table {
    width: 100%;
    border-collapse: collapse;
    font-size: 14px;
}
.docs-table th, .docs-table td {
    text-align: left;
    padding: 9px 12px;
    border-bottom: 1px solid var(--docs-border);
    vertical-align: top;
}
.docs-table th {
    font-family: var(--docs-font-mono);
    font-size: 11px;
    letter-spacing: .04em;
    text-transform: uppercase;
    color: var(--docs-muted-soft);
}
.docs-table td code { white-space: nowrap; }

/* ---------- Callouts + endpoint cards ---------- */
.callout {
    border-left: 3px solid var(--docs-border-strong);
    background: var(--docs-surface);
    border-radius: 0 12px 12px 0;
    padding: 14px 18px;
    margin: 20px 0;
    font-size: 14.5px;
    color: #33332E; /* explicit dark text so the tinted backgrounds stay high-contrast */
}
.callout--info { border-left-color: var(--docs-green); background: var(--docs-green-tint); }
.callout--warn { border-left-color: var(--docs-gold); background: var(--docs-gold-tint); }
.callout--tip  { border-left-color: var(--docs-green); background: var(--docs-green-tint); }
.callout strong { font-family: var(--docs-font-display); color: var(--docs-ink); }

.endpoint {
    display: flex; align-items: center; gap: 10px;
    font-family: var(--docs-font-mono);
    font-size: 14px;
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 10px;
    padding: 10px 14px;
    margin: 14px 0;
    overflow-x: auto;
}
.endpoint .path { color: var(--docs-ink); font-weight: 500; }

/* ---------- Reference (renderer host) ---------- */
.docs-reference-wrap { max-width: 1120px; margin: 0 auto; }
.docs-reference { min-height: 70vh; }

/* ---------- Footer ---------- */
.docs-foot {
    border-top: 1px solid var(--docs-border);
    padding: 28px 40px;
    text-align: center;
    color: var(--docs-muted-soft);
    font-size: 13.5px;
}
.docs-foot a { color: var(--docs-muted); text-decoration: none; }
.docs-foot a:hover { color: var(--docs-green-dark); text-decoration: none; }

/* ---------- Responsive ---------- */
/* Collapse the code rail first: prose full-width, code flows inline below it. */
@media (max-width: 1100px) {
    .docs-block {
        grid-template-columns: 1fr;
        gap: 0;
        padding: 30px 0;
    }
    .docs-block__code {
        position: static;
        margin: 18px 0 4px;
    }
    .docs-main--split .docs-content { max-width: var(--docs-content-max); }
    .docs-main--split { padding: 44px 40px 100px; }
}

@media (max-width: 900px) {
    .docs-shell { grid-template-columns: 1fr; }
    .docs-sidebar {
        position: fixed;
        top: var(--docs-nav-h);
        left: 0;
        width: 82%;
        max-width: 320px;
        background: var(--docs-surface);
        transform: translateX(-100%);
        transition: transform .22s ease;
        z-index: 45;
        box-shadow: 0 20px 60px rgba(0,0,0,.18);
    }
    body.docs.nav-open .docs-sidebar { transform: translateX(0); }
    .docs-nav__toggle { display: block; }
    .docs-nav__links { display: none; }
    .docs-main,
    .docs-main--split { padding: 28px 20px 80px; }
}

/* ==========================================================================
   Docs hub — the two-door landing at "/" (Help Center + API docs).
   Rendered with $layout='full' (no sidebar).
   ========================================================================== */
.docs-hub {
    max-width: 920px;
    margin: 0 auto;
    padding: 72px 24px 96px;
}
.docs-hub__head { text-align: center; margin-bottom: 48px; }
.docs-hub__head h1 {
    font-family: var(--docs-font-display);
    font-weight: 800;
    font-size: clamp(2rem, 4vw, 2.9rem);
    margin: 0 0 12px;
}
.docs-hub__head p { color: var(--docs-muted); font-size: 1.125rem; margin: 0; }
.docs-hub__cards {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: 24px;
}
.docs-hub__card {
    display: flex;
    flex-direction: column;
    align-items: flex-start;
    gap: 10px;
    padding: 32px;
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 18px;
    text-decoration: none;
    transition: border-color .15s ease, box-shadow .15s ease, transform .15s ease;
}
.docs-hub__card:hover {
    border-color: var(--docs-border-strong);
    box-shadow: 0 14px 34px rgba(29, 29, 26, 0.1);
    transform: translateY(-3px);
}
.docs-hub__icon {
    font-size: 30px;
    color: var(--docs-green);
    background: var(--docs-green-tint);
    width: 58px;
    height: 58px;
    border-radius: 14px;
    display: grid;
    place-items: center;
    margin-bottom: 6px;
}
.docs-hub__card-title {
    font-family: var(--docs-font-display);
    font-weight: 700;
    font-size: 1.35rem;
    color: var(--docs-ink);
}
.docs-hub__card-text { color: var(--docs-muted); font-size: 0.975rem; line-height: 1.55; }
.docs-hub__card-cta {
    margin-top: 8px;
    display: inline-flex;
    align-items: center;
    gap: 6px;
    font-family: var(--docs-font-display);
    font-weight: 600;
    color: var(--docs-green-dark);
}
.docs-hub__card-cta .material-icons { font-size: 18px; transition: transform .15s ease; }
.docs-hub__card:hover .docs-hub__card-cta .material-icons { transform: translateX(3px); }

/* ==========================================================================
   Product roadmap — "/roadmap". Rendered with $layout='full' (no sidebar);
   content from app/roadmap-registry.php via view/docs/roadmap.php.
   ========================================================================== */
.roadmap {
    max-width: 860px;
    margin: 0 auto;
    padding: 64px 24px 96px;
}
.roadmap__head { text-align: center; margin-bottom: 26px; }
.roadmap__head h1 {
    font-family: var(--docs-font-display);
    font-weight: 800;
    font-size: clamp(2rem, 4vw, 2.9rem);
    letter-spacing: -0.02em;
    margin: 0 0 12px;
}
.roadmap__head > p {
    color: var(--docs-muted);
    font-size: 1.125rem;
    max-width: 640px;
    margin: 0 auto;
}
.roadmap__legend {
    margin-top: 18px;
    font-size: 13.5px;
    color: var(--docs-muted);
}
.roadmap__disclaimer { margin: 26px 0 0; }
.roadmap__disclaimer a { color: var(--docs-green-dark); font-weight: 600; text-decoration: none; }
.roadmap__disclaimer a:hover { text-decoration: underline; }

/* In-page jump nav */
.roadmap__jump {
    display: flex;
    flex-wrap: wrap;
    gap: 10px;
    justify-content: center;
    margin: 26px 0 10px;
}
.roadmap__jump a {
    display: inline-flex;
    align-items: center;
    gap: 7px;
    font-family: var(--docs-font-display);
    font-weight: 600;
    font-size: 14px;
    color: var(--docs-ink);
    text-decoration: none;
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 999px;
    padding: 7px 15px;
    transition: border-color .15s ease, box-shadow .15s ease;
}
.roadmap__jump a:hover {
    border-color: var(--docs-border-strong);
    box-shadow: 0 6px 16px rgba(29, 29, 26, 0.08);
}
.roadmap__jump-count {
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    color: var(--docs-green-dark);
    background: var(--docs-green-tint);
    border-radius: 999px;
    padding: 1px 7px;
}

/* Horizon sections */
.roadmap__horizon { margin-top: 48px; scroll-margin-top: calc(var(--docs-nav-h) + 16px); }
.roadmap__horizon-head {
    display: flex;
    align-items: center;
    gap: 12px;
    border-bottom: 1px solid var(--docs-border);
    padding-bottom: 10px;
}
.roadmap__horizon-head h2 {
    font-family: var(--docs-font-display);
    font-weight: 800;
    font-size: 1.7rem;
    letter-spacing: -0.01em;
    margin: 0;
}
.roadmap__horizon-blurb { color: var(--docs-muted); margin: 10px 0 20px; }

/* Item cards */
.roadmap-card {
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 18px;
    padding: 26px 28px;
    margin-bottom: 18px;
    scroll-margin-top: calc(var(--docs-nav-h) + 16px);
    transition: border-color .15s ease, box-shadow .15s ease;
}
.roadmap-card:hover { border-color: #CDEBDA; }
.roadmap-card[open] { box-shadow: 0 1px 3px rgba(0,0,0,.04); }
.roadmap-card__top {
    display: flex;
    align-items: flex-start;
    gap: 16px;
    cursor: pointer;
    list-style: none;
    user-select: none;
}
.roadmap-card__top::-webkit-details-marker { display: none; }
.roadmap-card__top:focus-visible {
    outline: 2px solid var(--docs-green);
    outline-offset: 4px;
    border-radius: 8px;
}
.roadmap-card__chev {
    flex: none;
    color: var(--docs-muted-soft);
    font-size: 24px;
    margin-top: 8px;
    transition: transform .2s ease;
}
.roadmap-card[open] .roadmap-card__chev { transform: rotate(180deg); }
.roadmap-card__icon {
    flex: none;
    font-size: 24px;
    color: var(--docs-green);
    background: var(--docs-green-tint);
    width: 46px;
    height: 46px;
    border-radius: 12px;
    display: grid;
    place-items: center;
}
.roadmap-card__titles { min-width: 0; flex: 1; }
.roadmap-card__titles h3 {
    font-family: var(--docs-font-display);
    font-weight: 700;
    font-size: 1.25rem;
    letter-spacing: -0.01em;
    margin: 2px 0 4px;
}
.roadmap-card__summary { color: var(--docs-muted); font-size: 15px; margin: 0; }
.roadmap-card__tag {
    flex: none;
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    letter-spacing: .04em;
    text-transform: uppercase;
    color: var(--docs-muted);
    background: var(--docs-canvas);
    border: 1px solid var(--docs-border);
    border-radius: 999px;
    padding: 3px 10px;
    margin-top: 4px;
}
.roadmap-card__body { margin-top: 14px; }
.roadmap-card__body p { color: #33332E; font-size: 15px; margin: 0 0 12px; }
.roadmap-card__points-title {
    font-family: var(--docs-font-mono);
    font-size: 11px;
    font-weight: 600;
    letter-spacing: .06em;
    text-transform: uppercase;
    color: var(--docs-muted-soft);
    margin: 16px 0 8px !important;
}
.roadmap-card__points {
    list-style: none;
    margin: 0;
    padding: 0;
}
.roadmap-card__points li {
    position: relative;
    color: #33332E;
    font-size: 14.5px;
    padding: 3px 0 3px 24px;
}
.roadmap-card__points li::before {
    content: "check";
    font-family: "Material Icons";
    position: absolute;
    left: 0;
    top: 5px;
    font-size: 16px;
    color: var(--docs-green);
}

/* "On our radar" list */
.roadmap-radar {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(260px, 1fr));
    gap: 12px;
}
.roadmap-radar li {
    background: var(--docs-surface);
    border: 1px solid var(--docs-border);
    border-radius: 14px;
    padding: 16px 18px;
    font-size: 14.5px;
}
.roadmap-radar strong {
    display: block;
    font-family: var(--docs-font-display);
    font-weight: 700;
    color: var(--docs-ink);
    margin-bottom: 3px;
}
.roadmap-radar span { color: var(--docs-muted); }

/* Closing CTA */
.roadmap__cta {
    margin-top: 56px;
    text-align: center;
    background: var(--docs-green-tint);
    border: 1px solid #CDEBDA;
    border-radius: 18px;
    padding: 34px 28px;
}
.roadmap__cta h2 {
    font-family: var(--docs-font-display);
    font-weight: 800;
    font-size: 1.5rem;
    margin: 0 0 8px;
}
.roadmap__cta p { color: #33332E; margin: 0 auto; max-width: 520px; }
.roadmap__cta a { color: var(--docs-green-dark); font-weight: 600; text-decoration: none; }
.roadmap__cta a:hover { text-decoration: underline; }

@media (max-width: 640px) {
    .roadmap { padding: 44px 18px 72px; }
    .roadmap-card { padding: 20px; }
    .roadmap-card__top { flex-wrap: wrap; }
    .roadmap-card__tag { order: -1; margin-left: 62px; }
    /* Keep the chevron pinned top-right on the first line, above the wrapped tag. */
    .roadmap-card__chev { order: -1; margin-top: 0; }
}