/* =============================================================================
   Docs & API Reference Styles
   Used by template-docs-index.php and template-api-tpv-orders.php
   ============================================================================= */

.docs-page {
    /* Docs-specific tokens (dark defaults, matching theme default) */
    --docs-font-mono: ui-monospace, 'SF Mono', 'Cascadia Code', Menlo, Consolas, monospace;
    --docs-code-bg: #101317;
    --docs-code-ink: #dddbd5;
    --docs-code-comment: #767d87;
    --docs-code-accent: #e3b74f;
    --docs-code-string: #9ec6a0;
    --docs-post: #58b381;
    --docs-post-wash: rgba(88, 179, 129, 0.12);
    --docs-get: #6fa3dd;
    --docs-get-wash: rgba(111, 163, 221, 0.12);
    --docs-accent-wash: rgba(212, 165, 48, 0.1);
}

[data-theme="light"] .docs-page {
    --docs-code-bg: #23272e;
    --docs-code-ink: #e6e4df;
    --docs-code-comment: #8b929b;
    --docs-post: #2f7d4f;
    --docs-post-wash: #e9f3ec;
    --docs-get: #2c64a8;
    --docs-get-wash: #e9f0f8;
    --docs-accent-wash: #faf3e2;
}

.docs-page {
    max-width: 900px;
    margin: 0 auto;
    padding: 7rem 2rem 6rem;
    font-size: 1rem;
    line-height: 1.65;
}

/* Breadcrumb */
.docs-breadcrumb {
    font-size: 0.85rem;
    color: var(--text-tertiary);
    margin-bottom: 1.5rem;
}

.docs-breadcrumb a {
    color: var(--text-tertiary);
    text-decoration: none;
}

.docs-breadcrumb a:hover {
    color: var(--accent-primary);
}

.docs-breadcrumb .breadcrumb-sep {
    margin: 0 0.5rem;
    opacity: 0.5;
}

/* ---------- Doc header ---------- */
.doc-head {
    padding-bottom: 2.25rem;
    border-bottom: 1px solid var(--border-strong);
}

.doc-brandline {
    display: flex;
    align-items: center;
    gap: 10px;
    margin-bottom: 1.5rem;
}

.doc-brandline .brand-dot {
    width: 10px;
    height: 10px;
    border-radius: 2px;
    background: var(--accent-primary);
    flex: none;
}

.doc-brandline span {
    font-size: 0.78rem;
    font-weight: 600;
    letter-spacing: 0.18em;
    text-transform: uppercase;
    color: var(--text-secondary);
}

.doc-title {
    font-family: var(--font-display);
    font-size: clamp(2rem, 5vw, 2.75rem);
    font-weight: 500;
    letter-spacing: -0.02em;
    line-height: 1.12;
    margin: 0 0 0.9rem;
    text-wrap: balance;
}

.doc-sub {
    font-size: 1.1rem;
    color: var(--text-secondary);
    max-width: 620px;
    margin: 0 0 1.6rem;
}

.doc-meta {
    display: flex;
    flex-wrap: wrap;
    gap: 8px 22px;
    font-size: 0.82rem;
    color: var(--text-tertiary);
}

.doc-meta b {
    color: var(--text-secondary);
    font-weight: 600;
}

.doc-meta code {
    background: none;
    border: none;
    padding: 0;
    font-family: var(--docs-font-mono);
    font-size: 0.95em;
}

/* ---------- TOC ---------- */
.doc-toc {
    padding: 1.6rem 0 0.5rem;
}

.doc-toc ol {
    list-style: none;
    margin: 0;
    padding: 0;
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(230px, 1fr));
    gap: 6px 28px;
}

.doc-toc a {
    display: flex;
    gap: 10px;
    align-items: baseline;
    text-decoration: none;
    color: var(--text-secondary);
    font-size: 0.91rem;
    padding: 4px 0;
    transition: color var(--transition-fast);
}

.doc-toc a:hover {
    color: var(--accent-primary);
}

.doc-toc .n {
    font-family: var(--docs-font-mono);
    font-size: 0.75rem;
    color: var(--accent-primary);
    flex: none;
}

/* ---------- Sections ---------- */
.docs-page section {
    margin-top: 3.6rem;
    scroll-margin-top: 5rem;
}

.sec-label {
    display: flex;
    align-items: baseline;
    gap: 12px;
    margin-bottom: 6px;
}

.sec-label .n {
    font-family: var(--docs-font-mono);
    font-size: 0.82rem;
    font-weight: 600;
    color: var(--accent-primary);
}

.docs-page h2 {
    font-family: var(--font-display);
    font-size: 1.5rem;
    font-weight: 500;
    letter-spacing: -0.015em;
    margin: 0 0 0.9rem;
    text-wrap: balance;
}

.docs-page h3 {
    font-size: 1.06rem;
    font-weight: 600;
    margin: 1.9rem 0 0.6rem;
}

.docs-page p {
    margin: 0 0 0.9rem;
    max-width: 720px;
    color: var(--text-primary);
}

.docs-page p.lead {
    color: var(--text-secondary);
}

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

.docs-page ul {
    list-style: disc;
    margin: 0 0 1rem;
    padding-left: 22px;
    max-width: 700px;
}

.docs-page li {
    margin-bottom: 6px;
}

.docs-page code {
    font-family: var(--docs-font-mono);
    font-size: 0.875em;
    background: var(--bg-tertiary);
    border: 1px solid var(--border-medium);
    border-radius: 4px;
    padding: 1px 5px;
    white-space: nowrap;
}

/* Endpoint banner */
.endpoint {
    display: flex;
    align-items: center;
    gap: 12px;
    flex-wrap: wrap;
    background: var(--bg-card-solid);
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-sm);
    padding: 12px 16px;
    margin: 1.1rem 0;
}

.endpoint .path {
    font-family: var(--docs-font-mono);
    font-size: 0.91rem;
    font-weight: 500;
    overflow-wrap: anywhere;
}

.method {
    font-family: var(--docs-font-mono);
    font-size: 0.75rem;
    font-weight: 600;
    letter-spacing: 0.06em;
    padding: 3px 9px;
    border-radius: 4px;
    flex: none;
}

.method.post {
    color: var(--docs-post);
    background: var(--docs-post-wash);
}

.method.get {
    color: var(--docs-get);
    background: var(--docs-get-wash);
}

/* Tables */
.tbl-scroll {
    overflow-x: auto;
    margin: 1rem 0 0.5rem;
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-sm);
    background: var(--bg-card-solid);
}

.docs-page table {
    border-collapse: collapse;
    width: 100%;
    font-size: 0.91rem;
}

.docs-page th {
    text-align: left;
    font-size: 0.72rem;
    font-weight: 600;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--text-tertiary);
    padding: 10px 16px;
    border-bottom: 1px solid var(--border-strong);
    background: var(--bg-tertiary);
    white-space: nowrap;
}

.docs-page td {
    padding: 10px 16px;
    border-bottom: 1px solid var(--border-subtle);
    vertical-align: top;
}

.docs-page tr:last-child td {
    border-bottom: none;
}

.docs-page td.f {
    font-family: var(--docs-font-mono);
    font-size: 0.82rem;
    white-space: nowrap;
}

.docs-page td.num {
    font-variant-numeric: tabular-nums;
}

.req {
    color: var(--accent-primary);
    font-size: 0.69rem;
    font-weight: 600;
    letter-spacing: 0.08em;
    text-transform: uppercase;
}

.opt {
    color: var(--text-tertiary);
    font-size: 0.69rem;
    font-weight: 500;
    letter-spacing: 0.08em;
    text-transform: uppercase;
}

/* Code blocks */
.docs-page pre {
    background: var(--docs-code-bg);
    color: var(--docs-code-ink);
    font-family: var(--docs-font-mono);
    font-size: 0.845rem;
    line-height: 1.6;
    border-radius: var(--radius-md);
    padding: 18px 20px;
    overflow-x: auto;
    margin: 1rem 0;
    border: 1px solid var(--border-medium);
}

.docs-page pre .c { color: var(--docs-code-comment); }
.docs-page pre .k { color: var(--docs-code-accent); }
.docs-page pre .s { color: var(--docs-code-string); }

.code-cap {
    font-size: 0.75rem;
    font-weight: 600;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--text-tertiary);
    margin: 1.25rem 0 -0.5rem;
}

/* Callouts */
.doc-note {
    background: var(--docs-accent-wash);
    border: 1px solid var(--border-medium);
    border-left: 3px solid var(--accent-primary);
    border-radius: var(--radius-sm);
    padding: 13px 18px;
    margin: 1.1rem 0;
    font-size: 0.91rem;
    max-width: 760px;
}

.doc-note b {
    font-weight: 600;
}

/* Flow strip */
.doc-flow {
    display: flex;
    gap: 0;
    align-items: stretch;
    margin: 1.5rem 0 0.5rem;
    overflow-x: auto;
    padding-bottom: 6px;
}

.flow-step {
    background: var(--bg-card-solid);
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-sm);
    padding: 14px 16px;
    min-width: 178px;
    flex: 1;
}

.flow-step .fs-n {
    font-family: var(--docs-font-mono);
    font-size: 0.69rem;
    color: var(--accent-primary);
    margin-bottom: 6px;
}

.flow-step .fs-t {
    font-weight: 600;
    font-size: 0.91rem;
    margin-bottom: 4px;
}

.flow-step .fs-d {
    font-size: 0.82rem;
    color: var(--text-tertiary);
    line-height: 1.5;
}

.flow-step .fs-d code {
    background: none;
    border: none;
    padding: 0;
}

.flow-arrow {
    display: flex;
    align-items: center;
    padding: 0 8px;
    color: var(--border-strong);
    flex: none;
    font-size: 1.1rem;
}

/* Status pills */
.pill-row {
    display: flex;
    align-items: center;
    gap: 10px;
    flex-wrap: wrap;
    margin: 1.1rem 0 1.25rem;
}

.pill-row .pill-arrow {
    color: var(--text-tertiary);
}

.doc-pill {
    display: inline-block;
    font-family: var(--docs-font-mono);
    font-size: 0.75rem;
    font-weight: 500;
    padding: 2px 9px;
    border-radius: var(--radius-full);
    border: 1px solid var(--border-strong);
    background: var(--bg-tertiary);
    white-space: nowrap;
}

.doc-pill.terminal {
    border-style: dashed;
    color: var(--text-tertiary);
}

/* Checklist cards */
.check-grid {
    display: grid;
    grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
    gap: 16px;
    margin-top: 1.1rem;
}

.check-card {
    background: var(--bg-card-solid);
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-md);
    padding: 18px 20px;
}

.check-card h4 {
    margin: 0 0 10px;
    font-size: 0.82rem;
    font-weight: 600;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--accent-primary);
}

.check-card ul {
    margin: 0;
    padding-left: 18px;
    font-size: 0.91rem;
}

.check-card li {
    margin-bottom: 7px;
}

/* Doc footer */
.doc-foot {
    margin-top: 4.5rem;
    padding-top: 1.5rem;
    border-top: 1px solid var(--border-strong);
    font-size: 0.82rem;
    color: var(--text-tertiary);
    display: flex;
    justify-content: space-between;
    flex-wrap: wrap;
    gap: 8px;
}

@media (max-width: 640px) {
    .doc-flow {
        flex-direction: column;
    }

    .flow-arrow {
        transform: rotate(90deg);
        padding: 4px 0;
        justify-content: center;
    }
}

/* =============================================================================
   Docs hub (index)
   ============================================================================= */

.docs-hub-sub {
    font-size: 1.1rem;
    color: var(--text-secondary);
    max-width: 620px;
    margin: 0 0 2.5rem;
}

.docs-hub-grid {
    display: grid;
    grid-template-columns: repeat(auto-fill, minmax(300px, 1fr));
    gap: 20px;
}

.docs-card {
    display: block;
    background: var(--bg-card-solid);
    border: 1px solid var(--border-strong);
    border-radius: var(--radius-md);
    padding: 24px 26px;
    text-decoration: none;
    color: inherit;
    transition: border-color var(--transition-fast), transform var(--transition-fast);
}

.docs-card:hover {
    border-color: var(--accent-primary);
    transform: translateY(-2px);
}

.docs-card-tag {
    font-family: var(--docs-font-mono);
    font-size: 0.69rem;
    font-weight: 600;
    letter-spacing: 0.1em;
    text-transform: uppercase;
    color: var(--accent-primary);
    margin-bottom: 10px;
}

.docs-card h2 {
    font-family: var(--font-display);
    font-size: 1.25rem;
    font-weight: 500;
    margin: 0 0 8px;
}

.docs-card p {
    font-size: 0.91rem;
    color: var(--text-secondary);
    margin: 0 0 14px;
    line-height: 1.55;
}

.docs-card .docs-card-cta {
    font-size: 0.85rem;
    font-weight: 600;
    color: var(--accent-primary);
}

.docs-hub-help {
    margin-top: 3rem;
    padding: 20px 24px;
    background: var(--docs-accent-wash);
    border: 1px solid var(--border-medium);
    border-left: 3px solid var(--accent-primary);
    border-radius: var(--radius-sm);
    font-size: 0.95rem;
    max-width: 720px;
}

.docs-hub-help a {
    color: var(--accent-primary);
}