/* ============================================================
   BOILERPLATE DOCS  —  reading experience (studio / refined light)
   Shared by docs_index.html + doc_detail.html.
   Depends on theme tokens (tokens.css) + build.css (.lw-*).
   Component grammar is namespaced .docs-* / .doc-content / .ix-*.
   ============================================================ */

:root { --docs-sticky-top: 104px; }  /* clears the sticky navbar (quicklinks + main row) */

/* Reading-progress bar — floats above the sticky navbar (z-50) */
.docs-progress {
  position: fixed; top: 0; left: 0; height: 3px; width: 0;
  background: linear-gradient(90deg, var(--accent), var(--accent-2));
  z-index: 60; transition: width .1s linear; pointer-events: none;
}

/* ---------- Layout shell ---------- */
.docs-grid {
  display: grid;
  grid-template-columns: 264px minmax(0, 1fr) 232px;
  gap: 2.75rem;
  align-items: start;
}
@media (max-width: 1023.98px) {
  .docs-grid { grid-template-columns: 1fr; gap: 0; }
}

/* Sticky rails. The sticky element must be the ASIDE (a direct grid child):
   its containing block is the full-height grid, so it has room to travel.
   Sticky on the inner .docs-side/.docs-toc would NOT work — with
   `align-items: start` each aside shrinks to its child's height, leaving the
   sticky child zero travel, so it would just scroll away. */
@media (min-width: 1024px) {
  .docs-grid > aside {
    position: sticky; top: var(--docs-sticky-top); align-self: start;
    max-height: calc(100vh - var(--docs-sticky-top) - 1rem); overflow-y: auto;
  }
  .docs-grid > aside::-webkit-scrollbar { width: 6px; }
  .docs-grid > aside::-webkit-scrollbar-thumb { background: var(--line); border-radius: 999px; }
}

/* ---------- Left sidebar (nav) ---------- */
.docs-side { padding: .25rem .25rem 2rem 0; }

.docs-side__head { display: flex; align-items: center; gap: .6rem; margin-bottom: 1.1rem; }
.docs-side__mark {
  width: 34px; height: 34px; border-radius: 9px; flex-shrink: 0; display: grid; place-items: center;
  background: color-mix(in srgb, var(--accent) 14%, transparent); color: var(--accent);
}
.docs-side__title { font-family: var(--font-display); font-weight: 700; font-size: .92rem; line-height: 1.15; letter-spacing: -.01em; color: var(--ink); }
.docs-side__sub { font-size: .68rem; color: var(--muted); font-family: var(--font-mono); margin-top: .1rem; }

/* nav search / filter */
.docs-search { position: relative; margin-bottom: 1.4rem; }
.docs-search input {
  width: 100%; font-family: var(--font-body); font-size: .82rem;
  padding: .5rem .75rem .5rem 2rem; border: 1px solid var(--line); border-radius: 9px;
  background: var(--surface); color: var(--ink); transition: border-color .15s ease, box-shadow .15s ease;
}
.docs-search input::placeholder { color: var(--muted); }
.docs-search input:focus { outline: none; border-color: var(--accent); box-shadow: 0 0 0 3px color-mix(in srgb, var(--accent) 16%, transparent); }
.docs-search__icon { position: absolute; left: .6rem; top: 50%; transform: translateY(-50%); color: var(--muted); pointer-events: none; display: flex; }
.docs-search__kbd { position: absolute; right: .5rem; top: 50%; transform: translateY(-50%); font-family: var(--font-mono); font-size: .62rem; color: var(--muted); border: 1px solid var(--line); border-radius: 5px; padding: .05rem .3rem; background: var(--surface-2); }

.docs-nav__all { display: block; text-decoration: none; color: var(--muted); font-size: .78rem; font-weight: 600; margin-bottom: 1.1rem; transition: color .12s ease; }
.docs-nav__all:hover { color: var(--ink); }
.docs-nav__group { margin-bottom: 1.35rem; }
.docs-nav__label { font-size: .68rem; font-weight: 800; letter-spacing: .12em; text-transform: uppercase; color: var(--muted); margin: 0 0 .5rem .1rem; }
.docs-nav__list { list-style: none; margin: 0; padding: 0 0 0 .1rem; border-left: 1.5px solid var(--line); }
.docs-nav__item > a {
  display: block; position: relative; margin-left: -1.5px; padding: .34rem .7rem;
  font-size: .85rem; line-height: 1.35; color: var(--muted); text-decoration: none;
  border-left: 1.5px solid transparent; transition: color .12s ease, border-color .12s ease, background .12s ease;
}
.docs-nav__item > a:hover { color: var(--ink); border-left-color: color-mix(in srgb, var(--accent) 45%, var(--line)); }
.docs-nav__item > a.is-active {
  color: var(--accent); font-weight: 600; border-left-color: var(--accent);
  background: color-mix(in srgb, var(--accent) 8%, transparent); border-radius: 0 7px 7px 0;
}
.docs-nav__empty { font-size: .8rem; color: var(--muted); padding: .5rem .7rem; display: none; }

/* ---------- Main content ---------- */
.docs-main { min-width: 0; max-width: 760px; }

.docs-breadcrumb { font-size: .8rem; color: var(--muted); margin-bottom: 1.5rem; display: flex; align-items: center; gap: .5rem; flex-wrap: wrap; }
.docs-breadcrumb a { text-decoration: none; color: var(--muted); }
.docs-breadcrumb a:hover { color: var(--ink); }
.docs-breadcrumb svg { opacity: .5; flex-shrink: 0; }
.docs-breadcrumb .cur { color: var(--ink); font-weight: 600; }

.docs-eyebrow { font-size: .72rem; font-weight: 800; letter-spacing: .1em; text-transform: uppercase; color: var(--accent-2); margin-bottom: .6rem; }
.docs-h1 { font-family: var(--font-display); font-weight: 600; letter-spacing: -.02em; font-size: clamp(2rem, 4vw, 2.85rem); line-height: 1.08; margin: 0 0 .9rem; color: var(--ink); }
.docs-lead { font-size: 1.18rem; line-height: 1.55; color: var(--muted); margin: 0 0 1.5rem; max-width: 62ch; }

.docs-meta { display: flex; align-items: center; gap: 1rem; flex-wrap: wrap; padding-bottom: 1.5rem; border-bottom: 1px solid var(--line); margin-bottom: 2.25rem; }
.docs-meta__item { display: inline-flex; align-items: center; gap: .4rem; font-size: .82rem; color: var(--muted); }
.docs-gh {
  display: inline-flex; align-items: center; gap: .45rem; font-size: .82rem; font-weight: 600;
  color: var(--ink); text-decoration: none; padding: .4rem .85rem; border: 1px solid var(--line);
  border-radius: 999px; transition: border-color .15s ease, color .15s ease, background .15s ease;
}
.docs-gh:hover { border-color: var(--accent); color: var(--accent); background: color-mix(in srgb, var(--accent) 7%, transparent); }

/* prev / next */
.docs-pager { display: grid; grid-template-columns: 1fr 1fr; gap: .9rem; margin-top: 3.5rem; padding-top: 2rem; border-top: 1px solid var(--line); }
.docs-pager a {
  display: block; padding: 1rem 1.15rem; text-decoration: none; border: 1px solid var(--line);
  border-radius: var(--radius); background: var(--surface); box-shadow: var(--shadow-sm);
  transition: transform .18s ease, box-shadow .18s ease, border-color .18s ease;
}
.docs-pager a:hover { transform: translateY(-3px); box-shadow: var(--shadow); border-color: color-mix(in srgb, var(--accent) 40%, var(--line)); }
.docs-pager__dir { font-size: .68rem; font-weight: 800; letter-spacing: .08em; text-transform: uppercase; color: var(--muted); margin-bottom: .3rem; }
.docs-pager__ttl { font-weight: 700; color: var(--ink); }
.docs-pager .next { text-align: right; }
@media (max-width: 639.98px) { .docs-pager { grid-template-columns: 1fr; } .docs-pager .next { text-align: left; } }

/* ---------- Right TOC ---------- */
.docs-toc { font-size: .82rem; }
.docs-toc__label { font-size: .68rem; font-weight: 800; letter-spacing: .12em; text-transform: uppercase; color: var(--muted); margin-bottom: .75rem; }
.docs-toc .toc { margin: 0; padding: 0; }
.docs-toc .toc > ul { list-style: none; margin: 0; padding: 0; border-left: 1.5px solid var(--line); }
.docs-toc ul { list-style: none; }
.docs-toc ul ul { margin: 0; padding: 0; }
.docs-toc li a { display: block; margin-left: -1.5px; padding: .28rem .75rem; color: var(--muted); text-decoration: none; line-height: 1.35; border-left: 1.5px solid transparent; transition: color .12s ease, border-color .12s ease; }
.docs-toc li a:hover { color: var(--ink); }
.docs-toc li a.is-active { color: var(--accent); font-weight: 600; border-left-color: var(--accent); }
.docs-toc ul ul a { padding-left: 1.5rem; font-size: .8rem; }
.docs-toc__top { display: inline-flex; align-items: center; gap: .35rem; margin-top: 1rem; font-size: .78rem; color: var(--muted); text-decoration: none; }
.docs-toc__top:hover { color: var(--accent); }
/* flat variant for the mobile "On this page" drawer (no sticky / no clip) */
.docs-toc--flat { position: static; max-height: none; overflow: visible; }

/* ============================================================
   .doc-content — rendered markdown
   ============================================================ */
.doc-content { color: var(--ink); font-size: 1.02rem; }
.doc-content > *:first-child { margin-top: 0; }

.doc-content h2 { font-family: var(--font-display); font-size: 1.7rem; font-weight: 600; letter-spacing: -.02em; margin: 2.75rem 0 1rem; line-height: 1.2; scroll-margin-top: 112px; position: relative; }
.doc-content h3 { font-family: var(--font-display); font-size: 1.3rem; font-weight: 600; margin: 2rem 0 .75rem; line-height: 1.3; scroll-margin-top: 112px; position: relative; }
.doc-content h4 { font-size: 1.1rem; font-weight: 700; margin: 1.5rem 0 .5rem; }

/* hover anchor (injected by docs.js) */
.doc-content .doc-anchor { position: absolute; left: -1.4rem; top: 0; color: var(--accent); opacity: 0; text-decoration: none; font-weight: 400; transition: opacity .12s ease; }
.doc-content h2:hover .doc-anchor, .doc-content h3:hover .doc-anchor { opacity: .6; }
.doc-content .doc-anchor:hover { opacity: 1 !important; }

.doc-content p { margin: 0 0 1.15rem; line-height: 1.75; color: color-mix(in srgb, var(--ink) 82%, transparent); }
.doc-content a:not(.doc-anchor) { color: var(--accent); text-decoration: underline; text-underline-offset: 3px; font-weight: 600; }
.doc-content a:not(.doc-anchor):hover { color: var(--accent-strong); }
.doc-content strong { color: var(--ink); font-weight: 700; }

.doc-content ul, .doc-content ol { margin: 1rem 0 1.25rem 1.35rem; }
.doc-content ul { list-style: disc; }
.doc-content ol { list-style: decimal; }
.doc-content li { margin-bottom: .5rem; line-height: 1.7; color: color-mix(in srgb, var(--ink) 82%, transparent); }
.doc-content li::marker { color: var(--muted); }
.doc-content li > ul, .doc-content li > ol { margin-top: .4rem; margin-bottom: .4rem; }

.doc-content hr { border: 0; border-top: 1px solid var(--line); margin: 2.5rem 0; }

/* inline code */
.doc-content code {
  background: color-mix(in srgb, var(--accent) 8%, var(--surface-2));
  border: 1px solid color-mix(in srgb, var(--accent) 14%, var(--line));
  border-radius: 6px; padding: 1px 6px; font-size: .86em; font-family: var(--font-mono);
  color: color-mix(in srgb, var(--ink) 90%, var(--accent));
}

/* ---- code-card: fenced-block chrome (wrapper + bar injected by docs.js) ---- */
.code-card { margin: 1.4rem 0 1.9rem; border-radius: var(--radius-sm); overflow: hidden; border: 1px solid var(--c-ink); box-shadow: var(--shadow); }
.code-card__bar { display: flex; align-items: center; gap: .6rem; background: #23232f; border-bottom: 1px solid rgba(255,255,255,.08); padding: .5rem .85rem; }
.code-card__dots { display: flex; gap: .35rem; }
.code-card__dots i { width: 10px; height: 10px; border-radius: 50%; display: block; }
.code-card__lang { margin-left: .2rem; font-family: var(--font-mono); font-size: .72rem; letter-spacing: .04em; text-transform: uppercase; color: #9a9aad; }
.code-card__copy { margin-left: auto; display: inline-flex; align-items: center; gap: .35rem; font-family: var(--font-body); font-size: .72rem; font-weight: 600; color: #c9d1d9; background: rgba(255,255,255,.06); border: 1px solid rgba(255,255,255,.1); padding: .25rem .55rem; border-radius: 6px; cursor: pointer; transition: background .15s ease, color .15s ease; }
.code-card__copy:hover { background: rgba(255,255,255,.13); color: #fff; }
.code-card__copy.is-copied { color: #7fd8c9; border-color: color-mix(in srgb, var(--signal) 60%, transparent); }

/* fenced code block (codehilite output) */
.doc-content .codehilite { background: var(--c-ink); color: #f5f5f7; margin: 0; overflow: hidden; }
.doc-content .codehilite pre { margin: 0; padding: 1rem 1.15rem; overflow-x: auto; font-size: .86rem; line-height: 1.65; font-family: var(--font-mono); }
.doc-content .codehilite code { background: transparent; border: 0; padding: 0; color: inherit; font-size: inherit; }
/* a bare codehilite that (defensively) wasn't wrapped keeps a rounded frame */
.doc-content > .codehilite, .doc-content > p > .codehilite { border-radius: var(--radius-sm); border: 1px solid var(--c-ink); box-shadow: var(--shadow); margin: 1.4rem 0 1.9rem; }

/* Pygments token palette — tuned for the dark code block */
.codehilite .k, .codehilite .kn, .codehilite .kd, .codehilite .kc { color: #f5b5c4; }
.codehilite .s, .codehilite .s1, .codehilite .s2, .codehilite .sb { color: #f5d76e; }
.codehilite .mi, .codehilite .mf, .codehilite .mh { color: #e8a07a; }
.codehilite .c, .codehilite .c1, .codehilite .cm { color: #7a7a8a; font-style: italic; }
.codehilite .n, .codehilite .nx, .codehilite .nv { color: #f5f5f7; }
.codehilite .nf, .codehilite .nb { color: #7fcfc3; }
.codehilite .nc, .codehilite .nn { color: #9b7cc4; }
.codehilite .o, .codehilite .ow { color: #f5b5c4; }
.codehilite .p { color: #cfcfdc; }
.codehilite .w { color: inherit; }
.codehilite .gp, .codehilite .gh, .codehilite .gu { color: var(--signal); font-weight: bold; }

/* tables */
.doc-content table { width: 100%; border-collapse: collapse; margin: 1.25rem 0 1.75rem; border: 1px solid var(--line); border-radius: var(--radius-sm); overflow: hidden; }
.doc-content th, .doc-content td { padding: .6rem .85rem; border: 1px solid var(--line); text-align: left; }
.doc-content th { background: var(--surface-2); font-weight: 700; }

/* blockquote */
.doc-content blockquote { border-left: 4px solid var(--accent); background: var(--surface-2); padding: .85rem 1rem .85rem 1.15rem; border-radius: 4px; margin: 1.25rem 0; color: color-mix(in srgb, var(--ink) 78%, transparent); }
.doc-content blockquote p { margin: 0; }

/* admonitions (callouts) */
.doc-content .admonition { border: 1px solid var(--line); border-left-width: 5px; border-radius: var(--radius-sm); padding: 1rem 1.15rem; margin: 1.4rem 0 1.6rem; background: var(--surface); box-shadow: var(--shadow-sm); }
.doc-content .admonition p { margin: 0 0 .5rem; }
.doc-content .admonition p:last-child { margin-bottom: 0; }
.doc-content .admonition-title { font-weight: 800; text-transform: uppercase; letter-spacing: .04em; font-size: .72rem; margin-bottom: .5rem !important; display: flex; align-items: center; gap: .45rem; }
.doc-content .admonition-title::before { content: ""; display: inline-block; width: .7rem; height: .7rem; border-radius: 50%; }

.doc-content .admonition.note { border-left-color: var(--muted); }
.doc-content .admonition.note .admonition-title::before { background: var(--muted); }
.doc-content .admonition.tip, .doc-content .admonition.hint { border-left-color: var(--signal); background: color-mix(in srgb, var(--signal) 5%, var(--surface)); }
.doc-content .admonition.tip .admonition-title, .doc-content .admonition.hint .admonition-title { color: color-mix(in srgb, var(--signal) 75%, var(--ink)); }
.doc-content .admonition.tip .admonition-title::before, .doc-content .admonition.hint .admonition-title::before { background: var(--signal); }
.doc-content .admonition.warning, .doc-content .admonition.caution { border-left-color: var(--accent-3); background: color-mix(in srgb, var(--accent-3) 5%, var(--surface)); }
.doc-content .admonition.warning .admonition-title, .doc-content .admonition.caution .admonition-title { color: color-mix(in srgb, var(--accent-3) 78%, var(--ink)); }
.doc-content .admonition.warning .admonition-title::before, .doc-content .admonition.caution .admonition-title::before { background: var(--accent-3); }
.doc-content .admonition.danger, .doc-content .admonition.error { border-left-color: var(--danger); background: color-mix(in srgb, var(--danger) 5%, var(--surface)); }
.doc-content .admonition.danger .admonition-title, .doc-content .admonition.error .admonition-title { color: color-mix(in srgb, var(--danger) 80%, var(--ink)); }
.doc-content .admonition.danger .admonition-title::before, .doc-content .admonition.error .admonition-title::before { background: var(--danger); }
.doc-content .admonition.ai-prompt, .doc-content .admonition.ai { border-left-color: var(--accent-2); background: color-mix(in srgb, var(--accent-2) 6%, var(--surface)); }
.doc-content .admonition.ai-prompt .admonition-title, .doc-content .admonition.ai .admonition-title { color: var(--accent-2); }
.doc-content .admonition.ai-prompt .admonition-title::before, .doc-content .admonition.ai .admonition-title::before { background: var(--accent-2); }
.doc-content .admonition.ai-prompt blockquote, .doc-content .admonition.ai blockquote { border-left-color: var(--accent-2); background: color-mix(in srgb, var(--accent-2) 5%, var(--surface)); }

/* entrance animation */
@keyframes docFadeUp { from { opacity: 0; transform: translateY(8px); } to { opacity: 1; transform: none; } }
.docs-anim { opacity: 0; animation: docFadeUp .5s ease forwards; }
@media (prefers-reduced-motion: reduce) { .docs-anim { animation: none; opacity: 1; } .docs-progress { display: none; } }

/* ============================================================
   DOCS INDEX  (.ix-*)
   ============================================================ */
.ix-start { display: flex; align-items: center; gap: 1.25rem; padding: 1.4rem 1.6rem; margin-bottom: 3rem; border-radius: var(--radius); text-decoration: none; border: 1px solid color-mix(in srgb, var(--accent) 25%, var(--line)); background: linear-gradient(120deg, color-mix(in srgb, var(--accent) 8%, var(--surface)), color-mix(in srgb, var(--accent-2) 6%, var(--surface))); transition: border-color .18s ease, box-shadow .18s ease; }
.ix-start:hover { border-color: color-mix(in srgb, var(--accent) 45%, var(--line)); box-shadow: var(--shadow); }
.ix-start__ico { width: 46px; height: 46px; border-radius: 12px; flex-shrink: 0; display: grid; place-items: center; background: var(--accent); color: #fff; box-shadow: 0 6px 16px color-mix(in srgb, var(--accent) 40%, transparent); }
.ix-start__body { flex: 1; min-width: 0; }
.ix-start__k { font-size: .7rem; font-weight: 800; letter-spacing: .1em; text-transform: uppercase; color: var(--accent); margin-bottom: .15rem; }
.ix-start__t { font-family: var(--font-display); font-weight: 600; font-size: 1.15rem; color: var(--ink); }
.ix-start__d { font-size: .9rem; color: var(--muted); margin-top: .1rem; }
@media (max-width: 639.98px) { .ix-start { flex-wrap: wrap; } }

.ix-group { margin-bottom: 2.75rem; }
.ix-group__head { display: flex; align-items: baseline; gap: .6rem; margin-bottom: 1.1rem; }
.ix-group__label { font-size: .74rem; font-weight: 800; letter-spacing: .12em; text-transform: uppercase; color: var(--ink); }
.ix-group__count { font-size: .72rem; color: var(--muted); font-family: var(--font-mono); }
.ix-group__rule { flex: 1; height: 1px; background: var(--line); }

.ix-grid { display: grid; grid-template-columns: repeat(2, 1fr); gap: 1rem; }
@media (max-width: 767.98px) { .ix-grid { grid-template-columns: 1fr; } }
.ix-card { position: relative; display: block; padding: 1.35rem 1.4rem; text-decoration: none; background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius); box-shadow: var(--shadow-sm); transition: transform .18s ease, box-shadow .18s ease, border-color .18s ease; }
.ix-card:hover { transform: translateY(-3px); box-shadow: var(--shadow); border-color: color-mix(in srgb, var(--accent) 45%, var(--line)); }
.ix-card__num { font-family: var(--font-mono); font-size: .72rem; font-weight: 600; color: var(--accent); background: color-mix(in srgb, var(--accent) 10%, transparent); border-radius: 6px; padding: .1rem .4rem; }
.ix-card__t { font-family: var(--font-display); font-weight: 600; font-size: 1.08rem; color: var(--ink); margin: .7rem 0 .4rem; line-height: 1.25; transition: color .15s ease; }
.ix-card:hover .ix-card__t { color: var(--accent); }
.ix-card__d { font-size: .88rem; line-height: 1.55; color: var(--muted); margin: 0 0 .9rem; }
.ix-card__read { display: inline-flex; align-items: center; gap: .3rem; font-size: .74rem; font-weight: 700; letter-spacing: .04em; text-transform: uppercase; color: var(--accent); }
.ix-card__read svg { transition: transform .18s ease; }
.ix-card:hover .ix-card__read svg { transform: translateX(3px); }