/* Trang tài liệu (/docs, /api-docs).
 *
 * Ngôn ngữ thị giác: giống trang bán hàng (một màu nhấn, nhiều khoảng trắng) để
 * khách không thấy như đang rời sản phẩm — nhưng dày hơn, vì đây là trang để
 * ĐỌC và COPY code.
 *
 * CSP của site là `style-src 'self'`, `script-src 'self'`: không CDN, không
 * inline. Vì vậy menu mobile dùng checkbox + label (CSS-only), và renderer
 * OpenAPI là của chúng tôi thay vì Scalar/Redoc.
 */

.docs-page {
	background: var(--bg);
}

/* ── thanh trên ───────────────────────────────────────────────────────────── */
.docs-top {
	display: flex;
	align-items: center;
	gap: 10px;
	padding: 12px 24px;
	border-bottom: 1px solid var(--line);
	background: var(--bg);
	position: sticky;
	top: 0;
	z-index: 20;
}

/* Wordmark: kiểu chữ (chữ HOA, letter-spacing, màu HUB) lấy từ `.brand` trong
   style.css. Ở đây không khai lại letter-spacing — bản âm cũ làm chữ HOA dính. */
.docs-brand {
	/* Logo + wordmark trên cùng một hàng (bề rộng ảnh do `.brand-logo` trong
	 * style.css quyết định; ở đây chỉ chỉnh cỡ cho vừa thanh header docs). */
	display: inline-flex;
	align-items: center;
	gap: 7px;
	color: var(--fg);
	text-decoration: none;
}

.docs-brand .brand-logo {
	height: 24px;
}

.docs-brand:hover {
	color: var(--accent);
}

.docs-tag {
	font-size: 10px;
	font-weight: 700;
	letter-spacing: 0.08em;
	text-transform: uppercase;
	color: var(--accent);
	background: #eef1ff;
	border-radius: 4px;
	padding: 2px 5px;
}

.docs-top-nav {
	margin-left: auto;
	display: flex;
	align-items: center;
	gap: 16px;
	font-size: 14px;
}

.docs-top-nav a {
	color: var(--fg-2);
	text-decoration: none;
}

.docs-top-nav a:hover {
	color: var(--fg);
}

.docs-top-nav .btn {
	color: #fff;
}

/* ── khung 2 cột ──────────────────────────────────────────────────────────── */
.docs-shell {
	display: grid;
	grid-template-columns: 244px minmax(0, 1fr);
	max-width: 1180px;
	margin: 0 auto;
}

/* Checkbox điều khiển menu mobile. Ẩn khỏi mắt nhưng vẫn focus được để bàn
   phím dùng được (thay cho nút + JS, vì CSP không cho inline handler). */
.ds-toggle {
	position: absolute;
	opacity: 0;
	pointer-events: none;
}

.ds-burger {
	display: none;
}

.docs-side {
	position: sticky;
	top: 57px;
	align-self: start;
	max-height: calc(100vh - 57px);
	overflow-y: auto;
	padding: 24px 16px 40px 24px;
	border-right: 1px solid var(--line-2);
	font-size: 13.5px;
}

.ds-group {
	margin: 18px 0 6px;
	font-size: 10.5px;
	font-weight: 700;
	letter-spacing: 0.07em;
	text-transform: uppercase;
	color: var(--fg-3);
}

.ds-group:first-child {
	margin-top: 0;
}

.ds-link {
	display: block;
	padding: 5px 9px;
	border-radius: 7px;
	color: var(--fg-2);
	text-decoration: none;
	line-height: 1.5;
}

.ds-link:hover {
	background: var(--bg-3);
	color: var(--fg);
}

.ds-link[aria-current="page"] {
	background: var(--bg-3);
	color: var(--fg);
	font-weight: 620;
}

/* ── nội dung ─────────────────────────────────────────────────────────────── */
.docs-main {
	min-width: 0;
	padding: 32px 40px 96px;
	max-width: 820px;
}

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

.doc-crumb {
	font-size: 12.5px;
	color: var(--fg-3);
	margin: 0 0 8px;
}

.doc-crumb a {
	color: var(--fg-3);
	text-decoration: none;
}

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

.doc-head h1 {
	font-size: 30px;
	letter-spacing: -0.025em;
	margin: 0 0 8px;
	font-weight: 680;
}

.doc-summary {
	font-size: 16px;
	color: var(--fg-2);
	margin: 0;
	line-height: 1.6;
}

.doc-section {
	margin: 34px 0;
}

.doc-section h2 {
	font-size: 19px;
	letter-spacing: -0.015em;
	margin: 0 0 12px;
	padding-bottom: 8px;
	border-bottom: 1px solid var(--line-2);
}

.docs-main p {
	color: var(--fg-2);
	line-height: 1.72;
	margin: 0 0 14px;
}

.docs-main p code,
.docs-main li code,
.docs-main td code,
.api-desc code {
	font-family: var(--mono);
	font-size: 0.9em;
	background: var(--bg-3);
	border: 1px solid var(--line-2);
	border-radius: 4px;
	padding: 1px 4px;
	color: var(--fg);
}

.docs-main ul,
.docs-main ol {
	margin: 0 0 16px;
	padding-left: 22px;
	color: var(--fg-2);
	line-height: 1.75;
}

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

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

/* ── code ─────────────────────────────────────────────────────────────────── */
.code-block {
	margin: 0 0 18px;
	border: 1px solid var(--line);
	border-radius: var(--radius);
	overflow: hidden;
	background: var(--bg-2);
}

.code-title {
	font-size: 11.5px;
	font-weight: 620;
	letter-spacing: 0.02em;
	color: var(--fg-3);
	padding: 7px 14px;
	background: var(--bg-3);
	border-bottom: 1px solid var(--line);
	font-family: var(--mono);
}

.code-block pre {
	margin: 0;
	padding: 14px 16px;
	overflow-x: auto;
}

.code-block code {
	font-family: var(--mono);
	font-size: 12.5px;
	line-height: 1.7;
	color: var(--fg);
	background: none;
	border: 0;
	padding: 0;
	white-space: pre;
}

/* ── ghi chú ──────────────────────────────────────────────────────────────── */
.note {
	display: flex;
	flex-direction: column;
	gap: 3px;
	margin: 0 0 18px;
	padding: 12px 14px;
	border-radius: var(--radius-sm);
	border: 1px solid var(--line);
	border-left: 3px solid var(--fg-3);
	background: var(--bg-2);
	font-size: 13.5px;
	line-height: 1.65;
	color: var(--fg-2);
}

.note b {
	color: var(--fg);
	font-weight: 620;
}

.note-tip {
	border-left-color: var(--ok);
	background: #f4fbf7;
}

.note-warn {
	border-left-color: #b25a2b;
	background: #fdf6f1;
}

.note-info {
	border-left-color: var(--accent);
	background: #f5f7ff;
}

/* ── bảng ─────────────────────────────────────────────────────────────────── */
.table-wrap {
	overflow-x: auto;
	margin: 0 0 18px;
	border: 1px solid var(--line);
	border-radius: var(--radius);
}

.docs-main table,
.api-table {
	width: 100%;
	border-collapse: collapse;
	font-size: 13px;
}

.docs-main th,
.docs-main td,
.api-table th,
.api-table td {
	text-align: left;
	padding: 8px 12px;
	border-bottom: 1px solid var(--line-2);
	vertical-align: top;
}

.docs-main thead th,
.api-table thead th {
	background: var(--bg-3);
	font-size: 10.5px;
	font-weight: 700;
	letter-spacing: 0.05em;
	text-transform: uppercase;
	color: var(--fg-3);
	white-space: nowrap;
}

.docs-main tbody tr:last-child td,
.api-table tbody tr:last-child td {
	border-bottom: 0;
}

/* ── điều hướng trước/sau ─────────────────────────────────────────────────── */
.doc-nav {
	display: flex;
	justify-content: space-between;
	gap: 16px;
	margin-top: 48px;
	padding-top: 20px;
	border-top: 1px solid var(--line);
}

.doc-prev,
.doc-next {
	display: flex;
	flex-direction: column;
	gap: 3px;
	max-width: 46%;
	text-decoration: none;
	color: var(--fg);
	font-weight: 560;
	font-size: 14px;
}

.doc-prev span,
.doc-next span {
	font-size: 11.5px;
	font-weight: 600;
	letter-spacing: 0.04em;
	text-transform: uppercase;
	color: var(--fg-3);
}

.doc-next {
	text-align: right;
	margin-left: auto;
}

.doc-prev:hover,
.doc-next:hover {
	color: var(--accent);
}

/* ── trang chỉ mục ────────────────────────────────────────────────────────── */
.doc-group {
	margin: 32px 0;
}

.doc-group h2 {
	font-size: 13px;
	text-transform: uppercase;
	letter-spacing: 0.06em;
	color: var(--fg-3);
	margin: 0 0 12px;
}

.doc-cards {
	display: grid;
	grid-template-columns: repeat(auto-fill, minmax(240px, 1fr));
	gap: 10px;
}

.doc-card {
	display: flex;
	flex-direction: column;
	gap: 4px;
	padding: 14px 16px;
	border: 1px solid var(--line);
	border-radius: var(--radius);
	background: var(--bg);
	text-decoration: none;
	color: var(--fg-2);
	transition: border-color 0.12s, box-shadow 0.12s;
}

.doc-card:hover {
	border-color: #d8dce6;
	box-shadow: var(--shadow-sm);
}

.doc-card b {
	color: var(--fg);
	font-size: 14.5px;
	font-weight: 620;
}

.doc-card span {
	font-size: 12.5px;
	line-height: 1.55;
}

/* ── API reference ────────────────────────────────────────────────────────── */
.api-head h1 {
	font-size: 30px;
	letter-spacing: -0.025em;
	margin: 0 0 8px;
	font-weight: 680;
}

.api-sub {
	color: var(--fg-2);
	font-size: 14px;
	line-height: 1.65;
	margin: 0 0 14px;
}

.api-jump {
	display: flex;
	flex-wrap: wrap;
	gap: 8px;
	margin: 0 0 16px;
}

.api-jump a {
	font-size: 12.5px;
	padding: 4px 10px;
	border-radius: 999px;
	border: 1px solid var(--line);
	color: var(--fg-2);
	text-decoration: none;
	background: var(--bg-2);
}

.api-jump a:hover {
	border-color: var(--fg-3);
	color: var(--fg);
}

.api-tag {
	margin: 40px 0;
}

.api-tag h2 {
	font-size: 20px;
	letter-spacing: -0.015em;
	margin: 0 0 4px;
	padding-bottom: 8px;
	border-bottom: 1px solid var(--line);
}

.api-tag-desc {
	font-size: 13.5px;
	color: var(--fg-3);
	margin: 8px 0 20px;
	line-height: 1.6;
}

.api-op {
	border: 1px solid var(--line);
	border-radius: var(--radius);
	padding: 16px 18px;
	margin: 0 0 16px;
	background: var(--bg);
}

.api-op-head {
	display: flex;
	align-items: center;
	gap: 10px;
	flex-wrap: wrap;
	margin-bottom: 8px;
}

.verb {
	font-family: var(--mono);
	font-size: 11px;
	font-weight: 700;
	letter-spacing: 0.04em;
	padding: 3px 8px;
	border-radius: 5px;
}

/* Màu theo method: GET đọc (xám), POST ghi (nhấn). Chỉ hai method trong spec
   nên hai màu là đủ — thêm màu chỉ làm mắt phải học thêm. */
.verb-get {
	background: #eef0f4;
	color: var(--fg-2);
}

.verb-post {
	background: #eef1ff;
	color: var(--accent-2);
}

.api-path {
	font-family: var(--mono);
	font-size: 13.5px;
	color: var(--fg);
	word-break: break-all;
}

.api-summary {
	margin: 0 0 6px;
	font-weight: 600;
	font-size: 14.5px;
	color: var(--fg);
}

.api-desc {
	font-size: 13.5px;
	color: var(--fg-2);
	line-height: 1.68;
	margin: 0 0 14px;
}

.api-op h4 {
	font-size: 11px;
	text-transform: uppercase;
	letter-spacing: 0.06em;
	color: var(--fg-3);
	margin: 18px 0 8px;
}

.api-param {
	display: flex;
	flex-wrap: wrap;
	gap: 8px;
	align-items: baseline;
	padding: 6px 0;
	border-bottom: 1px solid var(--line-2);
	font-size: 13px;
}

.api-param code {
	font-family: var(--mono);
	font-weight: 600;
}

.api-param-in,
.api-param-type {
	font-family: var(--mono);
	font-size: 11.5px;
	color: var(--fg-3);
	background: var(--bg-3);
	border-radius: 4px;
	padding: 1px 5px;
}

.api-param-desc {
	color: var(--fg-2);
	flex: 1 1 100%;
	font-size: 12.5px;
}

.api-table td.mono,
.mono {
	font-family: var(--mono);
	font-size: 12.5px;
}

.req {
	color: #b3251d;
	font-weight: 700;
}

/* ── mobile ──────────────────────────────────────────────────────────────────── */
@media (max-width: 860px) {
	.docs-shell {
		grid-template-columns: minmax(0, 1fr);
	}

	.ds-burger {
		display: block;
		position: sticky;
		top: 57px;
		z-index: 15;
		padding: 8px 24px;
		background: var(--bg);
		border-bottom: 1px solid var(--line);
		font-size: 14px;
		color: var(--fg-2);
		cursor: pointer;
	}

	.docs-side {
		display: none;
		position: static;
		max-height: none;
		border-right: 0;
		border-bottom: 1px solid var(--line);
		padding: 12px 20px 18px;
	}

	/* CSS-only: checkbox được check thì hiện menu. Không cần JS nên không phải
	   nới CSP `script-src 'self'`. */
	.ds-toggle:checked ~ .docs-side {
		display: block;
	}

	.docs-main {
		padding: 24px 20px 72px;
	}

	.doc-head h1,
	.api-head h1 {
		font-size: 25px;
	}
}