/* /developer/docs：文档页（scripts/build-developer.ts 生成，组件见 developer/docs-render.ts）。
   面分层（docs/site-design.md）：只用 site.css 的令牌；容器不画四边框（site-surfaces 守卫）；线只留给表格行。
   三栏：侧栏 · 正文 · 本页目录；1200px 以下收起目录，900px 以下侧栏收成一个「文档目录」按钮。 */

.dvd-shell { display: grid; grid-template-columns: 252px minmax(0, 1fr) 220px; max-width: 1440px; margin: 0 auto; }

/* ---------- 侧栏 ---------- */
.dvd-side { position: sticky; top: var(--nav-h, 64px); align-self: start; max-height: calc(100vh - var(--nav-h, 64px)); overflow-y: auto; padding: 2rem 1rem 2rem 1.5rem; scrollbar-width: thin; }
.dvd-home { display: flex; align-items: center; gap: 8px; margin-bottom: 1.4rem; font-weight: 600; color: var(--ink-strong); text-decoration: none; }
.dvd-nav > summary { display: none; }
.dvd-group { margin-bottom: 1.25rem; }
.dvd-gt { margin-bottom: 0.4rem; padding-left: 0.7rem; font-family: var(--font-body); font-size: 0.75rem; font-weight: 500; color: var(--mut-2); }
.dvd-groups a { display: block; padding: 0.32rem 0.7rem; border-radius: var(--radius-full); color: var(--mut); font-size: 0.875rem; line-height: 1.45; text-decoration: none; }
.dvd-groups a:hover { color: var(--ink-strong); background: var(--surface); }
.dvd-groups a.on { color: var(--ink-strong); background: var(--fill); font-weight: 600; }
.dvd-meta { margin-top: 1.6rem; padding-left: 0.7rem; font-family: var(--font-mono); font-size: 0.68rem; color: var(--mut-2); }

/* 搜索文档：侧栏顶上的胶囊按钮 + 弹层（<dialog>） */
.dvd-search-btn { display: flex; align-items: center; gap: 8px; width: 100%; height: 36px; margin: 0 0 1.2rem; padding: 0 10px 0 12px; border: 0; border-radius: var(--radius-full); background: var(--fill); color: var(--mut); font: 400 0.85rem/1 var(--font-body); cursor: pointer; }
.dvd-search-btn:hover { background: var(--fill-hover); color: var(--ink-strong); }
.dvd-search-btn span { flex: 1; text-align: left; }
.dvd-search-btn kbd { padding: 3px 6px; border-radius: 6px; background: var(--raised); color: var(--mut-2); font: 500 0.7rem/1 var(--font-mono); box-shadow: var(--elev-1); }
.dvd-search-btn[hidden] { display: none; }
.dvd-search { width: min(640px, calc(100vw - 32px)); max-height: min(560px, calc(100vh - 120px)); margin: 12vh auto auto; padding: 0; border: 0; border-radius: var(--radius-lg); background: var(--raised); color: var(--ink); box-shadow: var(--ring), var(--elev-3); overflow: hidden; }
.dvd-search::backdrop { background: rgba(10, 10, 10, 0.35); backdrop-filter: blur(2px); }
.dvd-search[open] { display: flex; flex-direction: column; }
.dvd-search__box { display: flex; align-items: center; gap: 10px; padding: 14px 16px; color: var(--mut); }
.dvd-search__box input { flex: 1; min-width: 0; border: 0; outline: 0; background: transparent; color: var(--ink-strong); font: 400 1rem/1.4 var(--font-body); }
.dvd-search__close { padding: 4px 8px; border: 0; border-radius: 6px; background: var(--fill); color: var(--mut); font: 500 0.72rem/1 var(--font-mono); cursor: pointer; }
.dvd-search__list { margin: 0; padding: 6px; overflow-y: auto; list-style: none; }
.dvd-search__list:empty { display: none; }
.dvd-search__list a { display: grid; gap: 2px; padding: 9px 12px; border-bottom: 0; border-radius: 10px; color: var(--ink); text-decoration: none; }
.dvd-search__list b { color: var(--ink-strong); font-weight: 600; font-size: 0.92rem; }
.dvd-search__list span { color: var(--mut); font-size: 0.78rem; }
.dvd-search__list li[aria-selected="true"] a, .dvd-search__list a:hover { background: var(--surface); }
.dvd-search__empty { padding: 14px 12px; color: var(--mut); font-size: 0.88rem; }

/* ---------- 正文 ---------- */
.dvd-main { position: relative; min-width: 0; width: 100%; max-width: 880px; justify-self: center; padding: 2.2rem clamp(20px, 4vw, 56px) 5rem; }
.dvd-crumb { display: flex; align-items: center; gap: 8px; margin: 0.4rem 0 0.8rem; font-size: 0.82rem; color: var(--mut-2); }
.dvd-crumb a { color: var(--mut); text-decoration: none; border-bottom: 0; }
.dvd-crumb a:hover { color: var(--ink-strong); }
.dvd-tools { float: right; display: flex; align-items: center; gap: 6px; margin: 0.2rem 0 1rem 1.2rem; }
.dvd-tool { display: inline-flex; align-items: center; gap: 6px; height: 32px; padding: 0 13px; border: 0; border-radius: var(--radius-full); background: var(--fill); color: var(--ink-strong); font: 500 0.82rem/1 var(--font-body); cursor: pointer; text-decoration: none; white-space: nowrap; }
.dvd-tool:hover { background: var(--fill-hover); }
.dvd-main a.dvd-tool { color: var(--mut); }
.dvd-tool--ghost { background: transparent; }

.dvd-main h1 { margin: 0 0 1rem; font-size: clamp(2rem, 4vw, 2.6rem); letter-spacing: -0.03em; }
.dvd-main h2 { margin: 3rem 0 0.9rem; font-size: 1.45rem; letter-spacing: -0.015em; }
.dvd-main h3 { margin: 1.9rem 0 0.6rem; font-size: 1.12rem; }
.dvd-body :is(h2, h3)[id] { scroll-margin-top: calc(var(--nav-h, 64px) + 20px); }
.dvd-body h1 + p { font-size: 1.06rem; color: var(--ink); }
.dvd-main p, .dvd-main li { color: var(--ink); line-height: 1.8; }
.dvd-main li + li { margin-top: 0.2rem; }
.dvd-main a { color: var(--signal); }
.dvd-main blockquote { margin: 1.2rem 0; padding: 0.9rem 1.2rem; border-radius: var(--radius-md); background: var(--surface); color: var(--mut); }
.dvd-main blockquote > :last-child { margin-bottom: 0; }
.dvd-main pre { margin: 1.1rem 0; padding: 1.05rem 1.25rem; border: 0; border-radius: var(--radius-md); background: var(--surface); overflow-x: auto; }
.dvd-main pre code { padding: 0; border: 0; background: none; font-size: 0.82rem; line-height: 1.7; color: var(--ink); }
.dvd-main :not(pre) > code { font-size: 0.84em; }
.dvd-main table { display: block; width: 100%; margin: 1.1rem 0; overflow-x: auto; border-collapse: collapse; font-size: 0.9rem; }
.dvd-main th, .dvd-main td { padding: 0.55rem 0.7rem; border-bottom: 1px solid var(--line-soft); text-align: left; vertical-align: top; }
.dvd-main th { font-weight: 600; color: var(--ink-strong); border-bottom-color: var(--line); white-space: nowrap; }
.dvd-main td code { white-space: nowrap; }
.dvd-main img { display: block; max-width: min(100%, 640px); height: auto; margin: 1.6rem auto; }
.dvd-raw { margin-top: 2.4rem; font-size: 0.82rem; color: var(--mut-2) !important; }

/* 代码高亮（highlight.js 的类） */
.dvd-main .hljs-keyword, .dvd-main .hljs-built_in, .dvd-main .hljs-literal { color: #c2410c; }
.dvd-main .hljs-string, .dvd-main .hljs-attr { color: #15803d; }
.dvd-main .hljs-comment { color: var(--mut-2); font-style: italic; }
.dvd-main .hljs-number, .dvd-main .hljs-title { color: #1d4ed8; }
[data-theme="dark"] .dvd-main .hljs-keyword { color: #fb923c; }
[data-theme="dark"] .dvd-main .hljs-string, [data-theme="dark"] .dvd-main .hljs-attr { color: #86efac; }
[data-theme="dark"] .dvd-main .hljs-number, [data-theme="dark"] .dvd-main .hljs-title { color: #93c5fd; }

/* 代码块的复制按钮（developer-docs.js 把 pre 包进 .dvd-code） */
.dvd-code { position: relative; }
.dvd-code > pre { margin: 1.1rem 0; }
.dvd-copy { position: absolute; top: 8px; right: 8px; display: inline-grid; place-items: center; width: 30px; height: 30px; border: 0; border-radius: var(--radius-full); background: var(--raised); color: var(--mut); box-shadow: var(--elev-1); cursor: pointer; opacity: 0; transition: opacity 0.15s var(--ease-out), color 0.15s; }
.dvd-code:hover .dvd-copy, .dvd-copy:focus-visible, .dvd-copy.is-done { opacity: 1; }
.dvd-copy:hover { color: var(--ink-strong); }
.dvd-copy.is-done { color: var(--leaf); }
@media (hover: none) { .dvd-copy { opacity: 1; } }

/* ---------- 提示框 > [!NOTE] ---------- */
.dvd-callout { margin: 1.3rem 0; padding: 0.95rem 1.2rem 1rem; border-radius: var(--radius-md); background: var(--surface); }
.dvd-main .dvd-callout p { margin: 0.3rem 0 0; line-height: 1.75; }
.dvd-callout > :last-child { margin-bottom: 0; }
.dvd-callout ul, .dvd-callout ol { margin: 0.4rem 0 0; }
.dvd-main .dvd-callout__t { display: flex; align-items: center; gap: 8px; margin: 0; font-size: 0.82rem; font-weight: 600; color: var(--ink-strong); }
.dvd-callout__t::before { content: ""; width: 8px; height: 8px; border-radius: var(--radius-full); background: var(--mut-2); }
.dvd-callout--tip { background: var(--leaf-soft); }
.dvd-callout--tip .dvd-callout__t::before { background: var(--leaf); }
.dvd-callout--important { background: var(--signal-soft); }
.dvd-callout--important .dvd-callout__t::before { background: var(--signal); }
.dvd-callout--warning, .dvd-callout--caution { background: color-mix(in srgb, #d97706 11%, transparent); }
.dvd-callout--warning .dvd-callout__t::before, .dvd-callout--caution .dvd-callout__t::before { background: #d97706; }

/* ---------- 终端演示 ```terminal 与交互界面录屏 ---------- */
/* 浅色主题里是一块深色的窗（与普通代码块区分）；深色主题里是浮起的卡。 */
.dvd-term { --term-bg: #141413; --term-fg: #d6d6d0; --term-in: #fafaf6; --term-mut: #7e7e78; margin: 1.4rem 0; overflow: hidden; border-radius: var(--radius-md); background: var(--term-bg); color: var(--term-fg); box-shadow: var(--elev-2); }
[data-theme="dark"] .dvd-term { --term-bg: var(--raised); box-shadow: var(--ring), var(--elev-2); }
.dvd-term__bar { display: flex; align-items: center; gap: 12px; height: 38px; padding: 0 8px 0 14px; background: rgba(255, 255, 255, 0.035); }
.dvd-term__dots { display: inline-flex; gap: 6px; }
.dvd-term__dots i { width: 10px; height: 10px; border-radius: var(--radius-full); background: rgba(255, 255, 255, 0.16); }
.dvd-term__title { flex: 1; min-width: 0; overflow: hidden; color: rgba(255, 255, 255, 0.55); font: 500 0.78rem/1 var(--font-body); text-overflow: ellipsis; white-space: nowrap; }
.dvd-term__acts { display: inline-flex; gap: 2px; }
.dvd-term__btn { display: inline-grid; place-items: center; width: 28px; height: 28px; border: 0; border-radius: var(--radius-full); background: transparent; color: rgba(255, 255, 255, 0.55); cursor: pointer; }
.dvd-term__btn:hover { background: rgba(255, 255, 255, 0.08); color: #fff; }
.dvd-term__btn.is-done { color: #7ee2a8; }
.dvd-term__btn[hidden] { display: none; }
.dvd-term pre.dvd-term__screen { margin: 0; padding: 14px 18px 18px; border-radius: 0; background: transparent; }
.dvd-term .dvd-term__screen code { display: block; color: var(--term-fg); font-family: var(--font-mono); font-size: 0.8rem; line-height: 1.7; white-space: pre-wrap; overflow-wrap: anywhere; }
/* 终端到窗口宽就折行（像真终端）；交互界面录屏是固定网格，不折 */
.dvd-term .dvd-tui code { white-space: pre; overflow-wrap: normal; }
.dvd-term__screen:focus-visible { outline: 2px solid var(--focus); outline-offset: -2px; }
.t-ps { color: #ff7a3d; user-select: none; }
.t-in { color: var(--term-in); font-weight: 500; }
.t-err { color: #ff8a80; }
.t-warn { color: #f5c26b; }
.t-ok { color: #7ee2a8; }
.t-hint { color: #ffb08a; }
.t-dim { color: var(--term-mut); }
.t-k { color: var(--term-in); }
.t-s { color: #a3dba9; }
.t-n { color: #f7c97e; }
.t-caret { display: inline-block; width: 0.6em; height: 1.2em; margin-left: 1px; vertical-align: -0.24em; background: var(--term-in); }
.t-idle .t-caret { animation: dvd-blink 1.1s steps(1) 5; }
.dvd-term.is-playing { cursor: pointer; }
.dvd-term.is-playing .t-pending { visibility: hidden; }
.dvd-term.is-playing .t-idle .t-caret { animation: none; opacity: 0; }
@keyframes dvd-blink { 50% { opacity: 0; } }

/* 交互界面录屏：等宽网格，宽字（中日韩、emoji）占两格；字号随窗口缩，整屏放得下 */
.dvd-term--tui { position: relative; container-type: inline-size; }
.dvd-term pre.dvd-tui { padding: 12px 14px 14px; }
.dvd-term .dvd-tui code { font-size: min(0.78rem, calc((100cqw - 28px) / (var(--cols, 100) * 0.6))); line-height: 1.25; }
.dvd-tui .w { display: inline-block; width: 2ch; }
.dvd-tui b { font-weight: 600; }
.dvd-tui i { font-style: italic; }
.dvd-tui u { text-decoration: underline; }
.dvd-term__play { position: absolute; right: 14px; bottom: 14px; display: inline-flex; align-items: center; gap: 6px; height: 32px; padding: 0 14px; border: 0; border-radius: var(--radius-full); background: rgba(255, 255, 255, 0.12); color: #fff; font: 500 0.8rem/1 var(--font-body); cursor: pointer; backdrop-filter: blur(6px); }
.dvd-term__play:hover { background: rgba(255, 255, 255, 0.2); }
.dvd-term__play[hidden] { display: none; }

@media (prefers-reduced-motion: reduce) {
  .t-idle .t-caret { animation: none; }
}

/* ---------- 上一页 / 下一页 ---------- */
.dvd-pager { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; margin-top: 3.5rem; }
.dvd-pager a { display: grid; gap: 4px; padding: 14px 18px; border-radius: var(--radius-md); background: var(--surface); text-decoration: none; transition: background 0.15s; }
.dvd-pager a:hover { background: var(--surface-hover); }
.dvd-pager span { color: var(--mut); font-size: 0.78rem; }
.dvd-pager b { color: var(--ink-strong); font-size: 0.95rem; font-weight: 600; }
.dvd-pager__next { grid-column: 2; text-align: right; }

/* ---------- 本页目录 ---------- */
.dvd-toc { position: sticky; top: var(--nav-h, 64px); align-self: start; max-height: calc(100vh - var(--nav-h, 64px)); overflow-y: auto; padding: 2.6rem 1.2rem 2rem 0.4rem; font-size: 0.8rem; scrollbar-width: thin; }
.dvd-toc:empty { display: none; }
.dvd-toc__t { margin: 0 0 0.6rem; padding-left: 0.6rem; color: var(--ink-strong); font-size: 0.78rem; font-weight: 600; }
.dvd-toc ul { display: grid; gap: 1px; margin: 0; padding: 0; list-style: none; }
.dvd-toc a { display: block; padding: 0.28rem 0.6rem; border-bottom: 0; border-radius: 8px; color: var(--mut); line-height: 1.45; text-decoration: none; overflow-wrap: anywhere; }
.dvd-toc .l3 a { padding-left: 1.3rem; font-size: 0.76rem; }
.dvd-toc a:hover { color: var(--ink-strong); }
.dvd-toc a.on { color: var(--ink-strong); background: var(--surface); }
.dvd-toc code { padding: 0; border: 0; background: none; font-size: 0.92em; }

@media (max-width: 1200px) {
  .dvd-shell { grid-template-columns: 252px minmax(0, 1fr); }
  .dvd-toc { display: none; }
}
@media (max-width: 900px) {
  .dvd-shell { grid-template-columns: minmax(0, 1fr); }
  .dvd-side { position: static; max-height: none; padding: 1rem 16px 0; overflow: visible; }
  .dvd-home, .dvd-meta { display: none; }
  .dvd-search-btn { margin-bottom: 10px; }
  .dvd-nav { border-radius: var(--radius-md); background: var(--surface); }
  .dvd-nav > summary { display: flex; align-items: center; gap: 10px; padding: 12px 16px; font-size: 0.9rem; list-style: none; cursor: pointer; }
  .dvd-nav > summary::-webkit-details-marker { display: none; }
  .dvd-nav > summary span { color: var(--mut); }
  .dvd-nav > summary b { flex: 1; min-width: 0; overflow: hidden; color: var(--ink-strong); font-weight: 600; text-overflow: ellipsis; white-space: nowrap; }
  .dvd-nav > summary::after { content: ""; width: 7px; height: 7px; margin-right: 4px; border-right: 1.5px solid var(--mut); border-bottom: 1.5px solid var(--mut); transform: rotate(45deg) translateY(-2px); transition: transform 0.2s; }
  .dvd-nav[open] > summary::after { transform: rotate(-135deg) translateY(-2px); }
  .dvd-groups { max-height: 62vh; padding: 2px 10px 14px; overflow-y: auto; }
  .dvd-main { padding: 1.2rem 16px 4rem; }
  .dvd-tools { float: none; margin: 0 0 0.6rem; }
  .dvd-pager { grid-template-columns: 1fr; }
  .dvd-pager__next { grid-column: 1; }
}