/* ============================================================
   AIDC Docs — documentation layout (light theme)
   Loads after site.css; pages set <html data-theme="light">
   ============================================================ */

body { padding-top: var(--nav-h); }

.docs-shell {
  display: grid;
  grid-template-columns: 264px minmax(0, 1fr) 220px;
  gap: clamp(32px, 4vw, 64px);
  max-width: 1440px;
  margin: 0 auto;
  padding: 0 var(--pad-x);
  align-items: start;
}

/* ---------- sidebar ---------- */
.docs-side {
  position: sticky;
  top: var(--nav-h);
  height: calc(100vh - var(--nav-h));
  overflow-y: auto;
  padding: 2rem 1.2rem 3rem 0;
  border-right: 1px solid var(--line-soft);
  scrollbar-width: thin;
}
.docs-search {
  width: 100%;
  font-family: var(--font-mono);
  font-size: 0.78rem;
  padding: 0.6rem 0.8rem;
  border: 1px solid var(--line);
  background: var(--bg);
  color: var(--ink);
  margin-bottom: 1.6rem;
  outline: none;
  border-radius: var(--radius);
}
.docs-search:focus { border-color: var(--signal); }
.docs-search::placeholder { color: var(--mut-2); }

.side-group { margin-bottom: 0.4rem; }
.side-group > button {
  display: flex;
  align-items: center;
  justify-content: space-between;
  width: 100%;
  background: none;
  border: 0;
  cursor: pointer;
  font-family: var(--font-mono);
  font-size: 0.68rem;
  font-weight: 600;
  letter-spacing: 0.16em;
  text-transform: uppercase;
  color: var(--ink-strong);
  padding: 0.7rem 0.3rem;
}
.side-group > button .tw {
  font-size: 0.62rem;
  color: var(--mut-2);
  transition: transform .2s;
}
.side-group.collapsed > button .tw { transform: rotate(-90deg); }
.side-group ul { list-style: none; margin: 0 0 0.6rem; padding: 0; }
.side-group.collapsed ul { display: none; }
.side-group ul a {
  display: block;
  font-size: 0.85rem;
  color: var(--mut);
  padding: 0.42rem 0.9rem;
  border-left: 1px solid var(--line);
  transition: color .15s, border-color .15s, background .15s;
}
.side-group ul a:hover { color: var(--ink-strong); border-left-color: var(--mut); }
.side-group ul a.active {
  color: var(--signal);
  border-left: 2px solid var(--signal);
  background: var(--signal-soft);
  font-weight: 500;
}
.side-group ul li.hidden { display: none; }

/* ---------- article ---------- */
.docs-main { padding: 2.6rem 0 5rem; min-width: 0; }
.crumbs {
  display: flex;
  align-items: center;
  gap: 0.7em;
  font-family: var(--font-mono);
  font-size: 0.72rem;
  letter-spacing: 0.08em;
  color: var(--mut-2);
  margin-bottom: 2rem;
  text-transform: uppercase;
}
.crumbs .sep { color: var(--signal); }
.crumbs a:hover { color: var(--signal); }

.docs-main h1 {
  font-size: clamp(1.9rem, 3.6vw, 2.7rem);
  margin-bottom: 0.5rem;
}
.docs-main .doc-sub {
  font-size: 1.05rem;
  color: var(--mut);
  line-height: 1.75;
  max-width: 660px;
  margin-bottom: 2.4rem;
}
.docs-main h2 {
  font-size: 1.45rem;
  margin-top: 3rem;
  padding-top: 2.2rem;
  border-top: 1px solid var(--line-soft);
  scroll-margin-top: calc(var(--nav-h) + 24px);
}
.docs-main h3 {
  font-size: 1.08rem;
  margin-top: 2rem;
  scroll-margin-top: calc(var(--nav-h) + 24px);
}
.docs-main p, .docs-main li { font-size: 0.96rem; color: var(--ink); }
.docs-main ul, .docs-main ol { padding-left: 1.3rem; margin: 0 0 1.2em; }
.docs-main li { margin-bottom: 0.45em; }
.docs-main li::marker { color: var(--signal); }

/* heading anchors */
.h-anchor {
  opacity: 0;
  margin-left: 0.4em;
  color: var(--signal);
  border: 0 !important;
  font-weight: 400;
}
h2:hover .h-anchor, h3:hover .h-anchor { opacity: 1; }

/* ---------- callouts ---------- */
.callout {
  display: grid;
  grid-template-columns: auto 1fr;
  gap: 0.9rem;
  border: 1px solid var(--line);
  border-left: 3px solid var(--signal);
  background: var(--bg-2);
  padding: 1.1rem 1.3rem;
  margin: 1.6rem 0;
  font-size: 0.92rem;
}
.callout .ci {
  font-family: var(--font-mono);
  font-size: 0.66rem;
  font-weight: 600;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--signal);
  padding-top: 0.25rem;
}
.callout p { margin: 0; }
.callout p + p { margin-top: 0.6em; }
.callout--rule { border-left-color: var(--ink-strong); }
.callout--rule .ci { color: var(--ink-strong); }
.callout--warn { border-left-color: #c2410c; background: rgba(194, 65, 12, 0.06); }
.callout--warn .ci { color: #c2410c; }

/* ---------- definition rows (object/action reference) ---------- */
.def-row {
  display: grid;
  grid-template-columns: 200px 1fr;
  gap: 1.5rem;
  padding: 1.2rem 0;
  border-top: 1px solid var(--line-soft);
}
.def-row code.def-name {
  font-size: 0.85rem;
  font-weight: 600;
  color: var(--signal);
  background: none;
  border: 0;
  padding: 0;
}
.def-row .def-kind {
  display: block;
  font-family: var(--font-mono);
  font-size: 0.66rem;
  letter-spacing: 0.12em;
  text-transform: uppercase;
  color: var(--mut-2);
  margin-top: 0.4rem;
}
.def-row p { margin: 0 0 0.5em; font-size: 0.92rem; }

/* ---------- prev / next ---------- */
.doc-pager {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
  margin-top: 4rem;
  border-top: 1px solid var(--line);
  padding-top: 1.5rem;
}
.doc-pager a {
  border: 1px solid var(--line);
  padding: 1.1rem 1.3rem;
  transition: border-color .18s, background .18s;
}
.doc-pager a:hover { border-color: var(--signal); background: var(--bg-2); }
.doc-pager .pl {
  font-family: var(--font-mono);
  font-size: 0.64rem;
  letter-spacing: 0.14em;
  text-transform: uppercase;
  color: var(--mut-2);
  display: block;
  margin-bottom: 0.4rem;
}
.doc-pager .pt { font-weight: 600; color: var(--ink-strong); font-size: 0.92rem; }
.doc-pager a.next { text-align: right; grid-column: 2; }
.doc-pager a.prev { grid-column: 1; }

/* ---------- right TOC ---------- */
.docs-toc {
  position: sticky;
  top: calc(var(--nav-h) + 40px);
  padding: 0 0 2rem;
  font-size: 0.8rem;
  max-height: calc(100vh - var(--nav-h) - 80px);
  overflow-y: auto;
}
.docs-toc h6 {
  font-family: var(--font-mono);
  font-size: 0.64rem;
  font-weight: 600;
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--mut-2);
  margin: 1.4rem 0 0.8rem;
}
.docs-toc ul { list-style: none; margin: 0; padding: 0; }
.docs-toc a {
  display: block;
  color: var(--mut);
  padding: 0.32rem 0 0.32rem 0.9rem;
  border-left: 1px solid var(--line);
  line-height: 1.45;
  transition: color .15s, border-color .15s;
}
.docs-toc a:hover { color: var(--ink-strong); }
.docs-toc a.active { color: var(--signal); border-left: 2px solid var(--signal); }
.docs-toc a.lvl-3 { padding-left: 1.8rem; font-size: 0.75rem; }

/* ---------- docs tables ---------- */
.docs-main table { font-size: 0.88rem; }
.docs-main th { background: var(--bg-2); }

/* ---------- responsive ---------- */
@media (max-width: 1180px) {
  .docs-shell { grid-template-columns: 240px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 860px) {
  .docs-shell { grid-template-columns: 1fr; }
  .docs-side {
    position: static;
    height: auto;
    max-height: none;
    border-right: 0;
    border-bottom: 1px solid var(--line);
    padding: 1.4rem 0;
  }
  .doc-pager { grid-template-columns: 1fr; }
  .doc-pager a.next { grid-column: 1; }
}
