/* Docs (DOCS.md): full-width three columns — sidebar · article · "On this page".
   Sidebar becomes a drawer below 1024px; "On this page" folds into the article below 1280px. */
@layer page {

.docs {
  --docs-side: 17.5rem;
  --docs-toc: 15rem;
  --docs-top: var(--header-h);
  display: grid;
  grid-template-columns: minmax(0, 1fr);
  min-height: calc(100vh - var(--docs-top));
  border-top: 1px solid var(--border);
}
@media (min-width: 1024px) {
  .docs { grid-template-columns: var(--docs-side) minmax(0, 1fr); }
}
@media (min-width: 1280px) {
  .docs { grid-template-columns: var(--docs-side) minmax(0, 1fr) var(--docs-toc); }
}

/* ---------- phone bar ---------- */
.docs-bar {
  position: sticky;
  top: var(--docs-top);
  z-index: var(--z-sticky);
  display: flex;
  gap: var(--space-2);
  padding: var(--space-2) var(--gutter, 16px);
  border-bottom: 1px solid var(--border);
  background: var(--bg);
}
.docs-bar-btn {
  display: inline-flex;
  align-items: center;
  gap: var(--space-2);
  min-height: 44px;
  padding: 0 var(--space-3);
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  background: var(--surface);
  color: var(--ink);
  font: inherit;
  font-size: var(--text-sm);
  cursor: pointer;
}
@media (min-width: 1024px) { .docs-bar { display: none; } }

/* ---------- sidebar ---------- */
.docs-sidebar {
  position: fixed;
  inset: 0 auto 0 0;
  z-index: var(--z-drawer);
  width: min(var(--docs-side), 86vw);
  overflow-y: auto;
  overscroll-behavior: contain;
  padding: var(--space-4) var(--space-4) var(--space-12);
  background: var(--bg);
  border-right: 1px solid var(--border);
  transform: translateX(-100%);
  transition: transform var(--dur-panel, 220ms) var(--ease-out, ease);
}
.docs.is-nav-open .docs-sidebar { transform: none; }
.docs-scrim { position: fixed; inset: 0; z-index: var(--z-scrim); background: var(--overlay); }
@media (min-width: 1024px) {
  .docs-sidebar {
    position: sticky;
    top: var(--docs-top);
    z-index: auto;
    width: auto;
    height: calc(100vh - var(--docs-top));
    transform: none;
    transition: none;
  }
  .docs-scrim { display: none; }
  .docs-sidebar-close { display: none; }
}
.docs-sidebar-head { display: flex; gap: var(--space-2); margin-bottom: var(--space-4); }
.docs-search-trigger {
  flex: 1;
  display: flex;
  align-items: center;
  gap: var(--space-2);
  min-height: 40px;
  padding: 0 var(--space-3);
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  background: var(--surface);
  color: var(--ink-3);
  font: inherit;
  font-size: var(--text-sm);
  cursor: pointer;
}
.docs-search-trigger span { flex: 1; text-align: left; }
.docs-search-trigger kbd {
  padding: 1px 6px;
  border: 1px solid var(--border);
  border-radius: var(--radius-xs);
  font-family: var(--font-mono);
  font-size: var(--text-2xs, 11px);
}
.docs-sidebar-close {
  width: 40px;
  border: 1px solid var(--border);
  border-radius: var(--radius-md);
  background: var(--surface);
  color: var(--ink);
  cursor: pointer;
}
.docs-nav ul { margin: 0; padding: 0; list-style: none; }
.docs-nav-group + .docs-nav-group { margin-top: var(--space-5); padding-top: var(--space-5); border-top: 1px solid var(--line-soft, var(--border)); }
.docs-nav-label {
  margin: 0 0 var(--space-2);
  padding: 0 var(--space-3);
  color: var(--ink);
  font-size: var(--text-xs);
  font-weight: var(--weight-semi);
  letter-spacing: 0.08em;
  text-transform: uppercase;
}
.docs-nav a {
  display: block;
  padding: 7px var(--space-3);
  border-radius: var(--radius-sm);
  color: var(--ink-2);
  font-size: 15px;
  line-height: 1.4;
  text-decoration: none;
}
.docs-nav a:hover { color: var(--ink); background: var(--surface-hover); }
.docs-nav a[aria-current="page"] { color: var(--accent-strong, var(--accent)); background: var(--accent-soft); font-weight: var(--weight-medium); }
.docs-nav-children { margin: 2px 0 4px var(--space-4) !important; padding-left: var(--space-2) !important; border-left: 1px solid var(--border); }

/* ---------- article ---------- */
.docs-content {
  min-width: 0;
  width: 100%;
  padding: var(--space-8) var(--gutter, 16px) var(--space-16);
}
@media (min-width: 1024px) { .docs-content { padding-inline: var(--space-12); } }
.docs-crumbs {
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-2);
  color: var(--accent-strong, var(--accent));
  font-size: var(--text-xs);
  font-weight: var(--weight-semi);
  letter-spacing: 0.06em;
  text-transform: uppercase;
}
.docs-crumbs a { color: inherit; text-decoration: none; }
.docs-crumbs span[aria-hidden] { color: var(--ink-3); }
.docs-title {
  margin: var(--space-4) 0 var(--space-3);
  color: var(--ink);
  font-size: clamp(1.75rem, 1.4rem + 1.2vw, 2.25rem);
  font-weight: var(--weight-semi);
  line-height: 1.2;
  letter-spacing: -0.01em;
}
.docs-lead { margin: 0 0 var(--space-6); color: var(--ink-2); font-size: 1.15rem; line-height: 1.65; }

.docs-toc-mobile { margin: 0 0 var(--space-6); border: 1px solid var(--border); border-radius: var(--radius-md); }
.docs-toc-mobile summary { min-height: 44px; display: flex; align-items: center; padding: 0 var(--space-4); color: var(--ink); font-weight: var(--weight-medium); cursor: pointer; }
.docs-toc-mobile ul { margin: 0; padding: 0 var(--space-4) var(--space-3); list-style: none; }
.docs-toc-mobile a { display: block; padding: 6px 0; color: var(--ink-2); text-decoration: none; }
@media (min-width: 1280px) { .docs-toc-mobile { display: none; } }

/* ---------- prose ---------- */
.docs-prose { color: var(--ink-2); font-size: 1rem; line-height: 1.75; }
.docs-prose > :first-child { margin-top: 0; }
.docs-content p, .docs-content ul, .docs-content ol { max-width: none; }
.docs-prose h2, .docs-prose h3 { color: var(--ink); scroll-margin-top: calc(var(--docs-top) + 72px); }
.docs-prose h2 { margin: var(--space-12) 0 var(--space-4); font-size: 1.5rem; font-weight: var(--weight-semi); line-height: 1.3; }
.docs-prose h3 { margin: var(--space-8) 0 var(--space-3); font-size: 1.15rem; font-weight: var(--weight-semi); line-height: 1.4; }
.docs-prose p, .docs-prose ul, .docs-prose ol { margin: 0 0 var(--space-4); }
.docs-prose ul, .docs-prose ol { padding-left: 1.4em; }
.docs-prose li + li { margin-top: var(--space-1); }
.docs-prose strong { color: var(--ink); font-weight: var(--weight-semi); }
.docs-prose a { color: var(--accent-strong, var(--accent)); text-decoration: underline; text-underline-offset: 3px; }
.docs-prose hr { margin: var(--space-10) 0; border: 0; border-top: 1px solid var(--border); }
.docs-prose :not(pre) > code {
  padding: 2px 6px;
  border: 1px solid var(--border);
  border-radius: var(--radius-xs);
  background: var(--code-bg);
  color: var(--code-ink, var(--ink));
  font-family: var(--font-mono);
  font-size: 0.875em;
  overflow-wrap: anywhere;
}

/* code blocks */
.docs-prose pre {
  position: relative;
  margin: var(--space-4) 0 var(--space-6);
  padding: var(--space-4) var(--space-5);
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  background: var(--code-bg);
  overflow-x: auto;
  font-family: var(--font-mono);
  font-size: 0.875rem;
  line-height: 1.65;
}
.docs-prose pre code { color: var(--code-ink, var(--ink)); white-space: pre; }
.docs-copy {
  position: absolute;
  top: var(--space-2);
  right: var(--space-2);
  min-height: 32px;
  padding: 0 var(--space-3);
  border: 1px solid var(--border);
  border-radius: var(--radius-sm);
  background: var(--surface);
  color: var(--ink-2);
  font: inherit;
  font-size: var(--text-xs);
  cursor: pointer;
  opacity: 0;
  transition: opacity var(--dur-quick, 120ms);
}
.docs-prose pre:hover .docs-copy, .docs-copy:focus-visible { opacity: 1; }
@media (hover: none) { .docs-copy { opacity: 1; } }
.tok-key { color: #c2410c; }
.tok-str { color: #15803d; }
.tok-num { color: #b45309; }
.tok-lit { color: #7c3aed; }
.tok-com { color: var(--ink-3); }
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) .tok-key { color: #fdba74; }
  :root:not([data-theme="light"]) .tok-str { color: #86efac; }
  :root:not([data-theme="light"]) .tok-num { color: #fcd34d; }
  :root:not([data-theme="light"]) .tok-lit { color: #c4b5fd; }
}
:root[data-theme="dark"] .tok-key { color: #fdba74; }
:root[data-theme="dark"] .tok-str { color: #86efac; }
:root[data-theme="dark"] .tok-num { color: #fcd34d; }
:root[data-theme="dark"] .tok-lit { color: #c4b5fd; }

/* tables */
.docs-table-scroll { margin: var(--space-4) 0 var(--space-6); overflow-x: auto; border: 1px solid var(--border); border-radius: var(--radius-lg); }
.docs-prose table { width: 100%; border-collapse: collapse; font-size: 0.9rem; line-height: 1.55; }
.docs-prose th, .docs-prose td { padding: var(--space-3) var(--space-4); text-align: left; vertical-align: top; border-bottom: 1px solid var(--line-soft, var(--border)); }
.docs-prose th { background: var(--bg-sunken); color: var(--ink); font-weight: var(--weight-semi); white-space: nowrap; }
.docs-prose tr:last-child td { border-bottom: 0; }
.docs-prose td code { white-space: nowrap; overflow-wrap: normal; }

/* hints (Markdown "!!! note" / "!!! warning" / "!!! tip") */
.docs-prose .admonition {
  margin: var(--space-5) 0;
  padding: var(--space-4) var(--space-5);
  border: 1px solid var(--border);
  border-left: 4px solid var(--info, var(--accent));
  border-radius: var(--radius-md);
  background: var(--surface);
}
.docs-prose .admonition > :last-child { margin-bottom: 0; }
.docs-prose .admonition-title { margin: 0 0 var(--space-1); color: var(--ink); font-weight: var(--weight-semi); }
.docs-prose .admonition.warning, .docs-prose .admonition.danger { border-left-color: var(--warn, #d97706); }
.docs-prose .admonition.tip { border-left-color: var(--ok, #16a34a); }

/* screenshots and videos */
.docs-figure { margin: var(--space-6) 0 var(--space-8); }
.docs-figure img, .docs-figure video {
  display: block;
  max-width: 100%;
  height: auto;
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  background: var(--bg-sunken);
  box-shadow: var(--shadow-2);
}
.docs-figure video { width: 100%; aspect-ratio: 16 / 9; }
.docs-figure figcaption { margin-top: var(--space-3); color: var(--ink-3); font-size: var(--text-sm); line-height: 1.5; }
.docs-figure.is-video figcaption::before { content: "▶ Video · "; color: var(--accent-strong, var(--accent)); font-weight: var(--weight-semi); }

/* pager */
.docs-pager { display: grid; grid-template-columns: 1fr 1fr; gap: var(--space-4); margin-top: var(--space-16); padding-top: var(--space-8); border-top: 1px solid var(--border); }
.docs-pager-link {
  display: block;
  padding: var(--space-4) var(--space-5);
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  color: var(--ink);
  text-decoration: none;
  transition: border-color var(--dur-quick, 120ms);
}
.docs-pager-link:hover { border-color: var(--accent); }
.docs-pager-link span { display: block; color: var(--ink-3); font-size: var(--text-xs); }
.docs-pager-link strong { font-weight: var(--weight-medium); }
.docs-pager-link.is-next { grid-column: 2; text-align: right; }
@media (max-width: 599px) {
  .docs-pager { grid-template-columns: 1fr; }
  .docs-pager-link.is-next { grid-column: auto; }
}

/* ---------- on this page ---------- */
.docs-toc { display: none; }
@media (min-width: 1280px) {
  .docs-toc {
    display: block;
    position: sticky;
    top: var(--docs-top);
    height: calc(100vh - var(--docs-top));
    overflow-y: auto;
    padding: var(--space-8) var(--space-6) var(--space-12) 0;
  }
}
.docs-toc ul { margin: 0; padding: 0; list-style: none; }
.docs-toc ul ul { margin: 2px 0 6px var(--space-3); padding-left: var(--space-3); border-left: 1px solid var(--border); }
.docs-toc-label { margin: 0 0 var(--space-3); color: var(--ink); font-size: var(--text-xs); font-weight: var(--weight-semi); letter-spacing: 0.08em; text-transform: uppercase; }
.docs-toc a { display: block; padding: 5px 0; color: var(--ink-3); font-size: 14px; line-height: 1.4; text-decoration: none; }
.docs-toc a:hover { color: var(--ink); }
.docs-toc a.is-active { color: var(--accent-strong, var(--accent)); font-weight: var(--weight-medium); }

/* ---------- search ---------- */
.docs-search { position: fixed; inset: 0; z-index: var(--z-modal); display: grid; place-items: start center; padding: 10vh var(--gutter, 16px) 0; background: var(--overlay); }
.docs-search[hidden] { display: none; }
.docs-search-panel {
  width: min(40rem, 100%);
  max-height: 70vh;
  display: flex;
  flex-direction: column;
  border: 1px solid var(--border);
  border-radius: var(--radius-lg);
  background: var(--bg-elevated, var(--surface));
  box-shadow: var(--shadow-pop);
  overflow: hidden;
}
.docs-search-input { min-height: 52px; padding: 0 var(--space-5); border: 0; border-bottom: 1px solid var(--border); background: transparent; color: var(--ink); font: inherit; font-size: 1rem; outline: none; }
.docs-search-results { flex: 1; margin: 0; padding: var(--space-2); overflow-y: auto; list-style: none; }
.docs-search-results a { display: block; padding: var(--space-3); border-radius: var(--radius-md); color: var(--ink); text-decoration: none; }
.docs-search-results a span { display: block; color: var(--ink-3); font-size: var(--text-xs); }
.docs-search-results a.is-active, .docs-search-results a:hover { background: var(--accent-soft); }
.docs-search-empty { padding: var(--space-4); color: var(--ink-3); }
.docs-search-hint { margin: 0; padding: var(--space-2) var(--space-4); border-top: 1px solid var(--border); color: var(--ink-3); font-size: var(--text-xs); }

}