/* ==========================================================================
   Nexus UI — Trang tài liệu API / Kết nối IDE + trang lỗi
   ========================================================================== */

.doc-page {
    min-height: 100vh;
    background:
        radial-gradient(900px 520px at 8% -12%, var(--bg-grad-1), transparent 66%),
        radial-gradient(760px 420px at 94% 0%, var(--bg-grad-2), transparent 62%),
        var(--bg);
    background-attachment: fixed;
}

.doc-nav {
    position: sticky;
    top: 0;
    z-index: 60;
    background: color-mix(in srgb, var(--bg) 80%, transparent);
    backdrop-filter: blur(16px);
    border-bottom: 1px solid var(--border);
}

.doc-nav-inner {
    max-width: clamp(1180px, 88vw, 1560px);
    margin: 0 auto;
    padding: 0 clamp(20px, 3vw, 40px);
    height: 68px;
    display: flex;
    align-items: center;
    gap: 18px;
}

.doc-brand {
    display: flex;
    align-items: center;
    gap: 10px;
    font-weight: 750;
    letter-spacing: -0.03em;
    font-size: 16px;
    min-height: 34px;
}

.doc-brand .logo-mark {
    width: 34px;
    height: 34px;
    border-radius: 11px;
    display: grid;
    place-items: center;
    color: #fff;
    background: linear-gradient(140deg, var(--primary), #a78bfa 55%, var(--primary-2));
}

.doc-brand .logo-mark .ico {
    width: 18px;
    height: 18px;
    stroke-width: 2;
}

.doc-nav-links {
    display: flex;
    align-items: center;
    gap: 4px;
    margin-left: 12px;
}

.doc-nav-links a {
    padding: 8px 13px;
    border-radius: 10px;
    font-size: 13.4px;
    font-weight: 550;
    color: var(--text-dim);
    transition: background var(--ease), color var(--ease);
}

.doc-nav-links a:hover,
.doc-nav-links a.active {
    background: var(--surface-hover);
    color: var(--text);
}

.doc-nav-links a.active {
    background: var(--primary-soft);
    box-shadow: inset 0 0 0 1px rgba(124, 108, 255, 0.28);
}

.doc-nav-right {
    margin-left: auto;
    display: flex;
    align-items: center;
    gap: 10px;
}

/* Nút menu mobile — ẩn trên desktop */
.doc-nav-toggle {
    display: none;
}

.doc-wrap {
    max-width: clamp(1180px, 88vw, 1560px);
    margin: 0 auto;
    padding: 40px clamp(20px, 3vw, 40px) 72px;
}

@media (min-width: 1600px) {
    .doc-nav-inner,
    .doc-wrap {
        padding-left: 48px;
        padding-right: 48px;
    }
}

.doc-head {
    margin-bottom: 32px;
}

.doc-head .eyebrow {
    display: inline-block;
    font-size: 11.5px;
    font-weight: 700;
    letter-spacing: 0.16em;
    text-transform: uppercase;
    color: var(--primary);
}

.doc-head h1 {
    margin-top: 12px;
    font-size: clamp(28px, 4vw, 44px);
    letter-spacing: -0.04em;
    line-height: 1.08;
}

.doc-head p {
    margin-top: 14px;
    font-size: 15px;
    line-height: 1.7;
    color: var(--text-dim);
    max-width: 68ch;
}

.doc-card {
    border-radius: var(--radius);
    border: 1px solid var(--border);
    background: var(--surface);
    box-shadow: var(--shadow-sm);
    padding: 22px 24px;
    margin-bottom: 18px;
}

.doc-card>h2 {
    font-size: 17px;
    letter-spacing: -0.02em;
    margin-bottom: 6px;
}

.doc-card>p {
    font-size: 13.6px;
    color: var(--text-dim);
    line-height: 1.7;
    margin-bottom: 14px;
}

.doc-card>p:last-child {
    margin-bottom: 0;
}

.doc-card .table-wrap {
    margin: 0;
    padding: 0;
}

.doc-card code:not(pre code) {
    padding: 2px 6px;
    border-radius: 6px;
    background: var(--surface-2);
    border: 1px solid var(--border);
    font-size: 12.4px;
    color: var(--primary);
    /* mã dài (URL, tên model) phải xuống dòng được, không tràn ngang */
    overflow-wrap: anywhere;
    word-break: break-word;
}

.doc-foot {
    border-top: 1px solid var(--border);
    padding: 26px 0 0;
    margin-top: 40px;
    font-size: 12.6px;
    color: var(--text-mute);
    display: flex;
    align-items: center;
    justify-content: space-between;
    gap: 16px;
    flex-wrap: wrap;
}

/* -------------------------------- CLIENTS -------------------------------- */
.client-grid {
    display: grid;
    grid-template-columns: repeat(2, minmax(0, 1fr));
    gap: 18px;
}

.client-card {
    border-radius: var(--radius);
    border: 1px solid var(--border);
    background: var(--surface);
    box-shadow: var(--shadow-sm);
    padding: 22px;
    display: flex;
    flex-direction: column;
    gap: 12px;
    transition: transform var(--ease), border-color var(--ease), box-shadow var(--ease);
}

.client-card:hover {
    transform: translateY(-3px);
    border-color: var(--border-strong);
    box-shadow: var(--shadow);
}

.client-head {
    display: flex;
    align-items: center;
    gap: 12px;
}

.client-logo {
    width: 40px;
    height: 40px;
    flex: none;
    border-radius: 12px;
    display: grid;
    place-items: center;
    font-size: 17px;
    background: var(--primary-soft);
    color: var(--primary);
}

.client-head h3 {
    font-size: 15.5px;
    letter-spacing: -0.01em;
}

.client-head p {
    font-size: 12.2px;
    color: var(--text-mute);
    margin-top: 2px;
}

.client-card ol,
.client-card ul {
    display: flex;
    flex-direction: column;
    gap: 8px;
    counter-reset: step;
    list-style: none;
}

.client-card ol li {
    display: flex;
    gap: 10px;
    font-size: 13.2px;
    color: var(--text-dim);
    line-height: 1.55;
}

.client-card ol li::before {
    counter-increment: step;
    content: counter(step);
    flex: none;
    width: 20px;
    height: 20px;
    border-radius: 6px;
    display: grid;
    place-items: center;
    font-size: 10.8px;
    font-weight: 700;
    font-family: var(--mono);
    background: var(--primary-soft);
    color: var(--primary);
    margin-top: 1px;
}

.client-card ul li {
    display: flex;
    align-items: flex-start;
    gap: 9px;
    font-size: 13.2px;
    color: var(--text-dim);
}

.client-card ul li .ico {
    width: 16px;
    height: 16px;
    color: var(--success);
    flex: none;
    margin-top: 2px;
}

/* Chuỗi dài (path, tên biến) phải ngắt dòng được thay vì tràn ra ngoài */
.client-card li code,
.client-card li span {
    min-width: 0;
    overflow-wrap: anywhere;
    word-break: break-word;
}

/* ================= HƯỚNG DẪN CHO NGƯỜI MỚI ================= */

/* Phím tắt hiển thị dạng nút bàn phím */
kbd {
    display: inline-block;
    padding: 2px 7px;
    margin: 0 1px;
    border-radius: 6px;
    border: 1px solid var(--border-strong);
    border-bottom-width: 2px;
    background: var(--surface-2);
    font-family: var(--mono);
    font-size: 11.6px;
    font-weight: 600;
    line-height: 1.5;
    color: var(--text);
    white-space: nowrap;
}

/* ── Danh sách bước (step-list) ── */
.step-list {
    display: flex;
    flex-direction: column;
    gap: 14px;
    margin-top: 18px;
    counter-reset: docstep;
}

.step {
    position: relative;
    display: flex;
    gap: 16px;
    padding: 18px 20px;
    border-radius: var(--radius);
    border: 1px solid var(--border);
    background: var(--surface);
    box-shadow: var(--shadow-sm);
}

/* Số bước lớn, dễ nhìn */
.step-num {
    flex: none;
    width: 34px;
    height: 34px;
    border-radius: 50%;
    display: grid;
    place-items: center;
    font-family: var(--mono);
    font-size: 15px;
    font-weight: 700;
    color: #fff;
    background: linear-gradient(135deg, var(--primary), color-mix(in srgb, var(--primary) 62%, #22d3ee));
    box-shadow: 0 3px 12px color-mix(in srgb, var(--primary) 34%, transparent);
}

.step-body {
    min-width: 0;
    flex: 1;
}

.step-body h3 {
    font-size: 15.6px;
    font-weight: 650;
    letter-spacing: -.015em;
    color: var(--text);
    line-height: 1.4;
}

.step-body p {
    margin: 8px 0 0;
    font-size: 13.6px;
    line-height: 1.75;
    color: var(--text-dim);
}

.step-body p + p {
    margin-top: 6px;
}

/* Gợi ý nhỏ trong bước */
.step-hint {
    margin-top: 10px !important;
    padding: 10px 14px;
    border-radius: 10px;
    border: 1px solid var(--border);
    background: var(--surface-2);
    font-size: 12.8px !important;
    line-height: 1.7;
    color: var(--text-mute) !important;
}

.step-hint strong {
    color: var(--text-dim);
}

/* ── Ví dụ thử nhanh (example-list) ── */
.example-list {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(290px, 1fr));
    gap: 12px;
    margin-top: 16px;
}

.example {
    display: flex;
    flex-direction: column;
    gap: 7px;
    padding: 15px 17px;
    border-radius: 12px;
    border: 1px solid var(--border);
    background: var(--surface);
    transition: border-color var(--ease), transform var(--ease);
}

.example:hover {
    border-color: var(--border-strong);
    transform: translateY(-2px);
}

.example-tag {
    align-self: flex-start;
    padding: 3px 9px;
    border-radius: 999px;
    font-size: 10.6px;
    font-weight: 700;
    letter-spacing: .05em;
    text-transform: uppercase;
    color: var(--primary);
    background: var(--primary-soft);
}

.example p {
    margin: 0;
    font-size: 13.2px;
    line-height: 1.65;
    color: var(--text);
}

.example p code {
    background: none;
    padding: 0;
    border: none;
    font-size: inherit;
    color: inherit;
    font-weight: 500;
}

.example small {
    font-size: 11.8px;
    line-height: 1.6;
    color: var(--text-mute);
}

/* ── Khối "Dành cho developer" — tách nhẹ khỏi phần người mới ── */
.doc-card--dev {
    border-style: dashed;
    border-color: var(--border-strong);
    background: var(--surface-2);
}

.doc-card--dev > h2 {
    color: var(--text-dim);
}

@media (max-width: 720px) {
    .step {
        padding: 15px 16px;
        gap: 12px;
    }

    .step-num {
        width: 28px;
        height: 28px;
        font-size: 13px;
    }

    .example-list {
        grid-template-columns: minmax(0, 1fr);
    }
}

/* ------------------------------- ERROR PAGE ------------------------------ */
.error-page {
    min-height: 100vh;
    display: grid;
    place-items: center;
    padding: 24px;
    background:
        radial-gradient(800px 460px at 50% -10%, var(--bg-grad-1), transparent 66%),
        var(--bg);
}

.error-box {
    width: 100%;
    max-width: 460px;
    text-align: center;
    padding: 40px 30px;
    border-radius: var(--radius-lg);
    border: 1px solid var(--border);
    background: var(--surface);
    box-shadow: var(--shadow);
}

.error-code {
    font-family: var(--mono);
    font-size: 62px;
    font-weight: 800;
    letter-spacing: -0.05em;
    line-height: 1;
    background: linear-gradient(135deg, var(--primary), #a78bfa 45%, var(--primary-2));
    -webkit-background-clip: text;
    background-clip: text;
    color: transparent;
}

.error-box h1 {
    margin-top: 14px;
    font-size: 21px;
    letter-spacing: -0.03em;
}

.error-box p {
    margin-top: 10px;
    font-size: 13.6px;
    color: var(--text-dim);
    line-height: 1.65;
}

.error-box .btn {
    margin-top: 22px;
}

/* ------------------------------- RESPONSIVE ----------------------------- */
@media (max-width: 820px) {
    .client-grid {
        grid-template-columns: minmax(0, 1fr);
    }

    /* --- Số dư + nút tài khoản: rút gọn để topbar vừa màn hình --- */
    .doc-nav-right .btn {
        padding: 7px 10px;
        font-size: 12px;
    }

    .doc-nav-right .balance-chip {
        padding: 6px 9px;
        font-size: 11.4px;
        min-height: 34px;
    }

    .doc-nav-toggle {
        display: grid;
        width: 38px;
        height: 38px;
        flex: none;
    }

    /* --- Thanh điều hướng: ẩn link, hiện nút menu --- */
    .doc-nav-inner {
        position: relative;
        height: 60px;
        padding: 0 16px;
        gap: 10px;
    }

    .doc-nav-links {
        display: none;
        position: absolute;
        top: 100%;
        left: 0;
        right: 0;
        flex-direction: column;
        align-items: stretch;
        gap: 2px;
        margin-left: 0;
        padding: 12px;
        max-height: calc(100dvh - 60px);
        overflow-y: auto;
        overscroll-behavior: contain;
        background: var(--surface-solid);
        border-bottom: 1px solid var(--border);
        box-shadow: var(--shadow);
    }

    .doc-nav-links.open {
        display: flex;
    }

    .doc-nav-links a {
        padding: 12px 14px;
        font-size: 14.5px;
        min-height: 44px;
        display: flex;
        align-items: center;
    }

    .doc-brand {
        font-size: 15px;
        gap: 9px;
        min-width: 0;
    }

    .doc-brand .logo-mark {
        width: 32px;
        height: 32px;
    }

    .doc-wrap {
        padding: 24px 16px 44px;
    }

    .doc-head {
        margin-bottom: 22px;
    }

    .doc-card {
        padding: 18px 16px;
    }

    /* Bảng: cho phép cuộn ngang trong .table-wrap */
    .doc-card .table-wrap {
        margin: 0 -16px;
        padding: 0 16px;
    }
}

/* --------------------- MOBILE NHỎ (≤ 480px) ----------------------------- */
@media (max-width: 480px) {
    .doc-wrap {
        padding: 20px 12px 40px;
    }

    .doc-card {
        padding: 16px 13px;
    }

    .doc-card .table-wrap {
        margin: 0 -13px;
        padding: 0 13px;
    }

    /* Ẩn nút Dashboard / Đăng ký dạng chữ, giữ nút menu + theme */
    .doc-nav-right .btn {
        padding: 8px 11px;
        font-size: 12px;
    }

    .doc-head h1 {
        font-size: 26px;
    }

    /* Code block: cuộn ngang bên trong, không vỡ layout */
    .code-block pre {
        padding: 12px 13px;
        font-size: 11.6px;
        line-height: 1.7;
    }

    .code-block-head {
        padding: 9px 11px;
    }

    .client-card {
        padding: 16px;
    }

    .error-box {
        padding: 30px 20px;
    }

    .error-code {
        font-size: 50px;
    }
}