/* ============================================================
   CRADL Dev Portal — documentation page
   Cockpit chrome outside (frame css), readable reader surface
   inside. Sidebar becomes an off-canvas drawer on small screens,
   the right-rail TOC becomes an inline disclosure.
   ============================================================ */

.frame-body.docs {
  padding: 0;
  overflow: hidden;
  display: grid;
  grid-template-columns: 240px minmax(0, 1fr) 220px;
  height: 100%;
}
@media (max-width: 1200px) {
  .frame-body.docs { grid-template-columns: 240px minmax(0, 1fr); }
  .docs-toc { display: none; }
}
@media (max-width: 900px) {
  .frame-body.docs { grid-template-columns: minmax(0, 1fr); }
}

/* ───────────────── sidebar */
.docs-sidebar {
  border-right: 1px solid var(--line);
  background: rgba(0, 0, 0, 0.4);
  padding: 16px 14px 24px;
  overflow-y: auto;
  height: 100%;
  font: 12px var(--font-mono);
  letter-spacing: 0.04em;
}
.docs-sidebar .nav-title {
  font-size: 10px;
  letter-spacing: 0.24em;
  text-transform: uppercase;
  color: var(--p-green-500);
  padding-bottom: 8px;
  border-bottom: 1px dashed var(--line);
  margin-bottom: 10px;
}
.docs-sidebar .filter {
  width: 100%;
  background: rgba(0,0,0,0.6);
  border: 1px solid var(--line);
  color: var(--p-green-300);
  padding: 6px 8px;
  font: 12px var(--font-mono);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  outline: none;
  margin-bottom: 12px;
}
.docs-sidebar .filter::placeholder { color: var(--line); }
.docs-sidebar .filter:focus { border-color: var(--p-green-400); color: var(--p-green-200); }
.docs-sidebar h3 {
  font: 10px var(--font-mono);
  letter-spacing: 0.22em;
  text-transform: uppercase;
  color: var(--line);
  margin: 14px 0 4px;
  padding-left: 4px;
}
.docs-sidebar h3:first-of-type { margin-top: 4px; }
.docs-sidebar ul { list-style: none; padding: 0; margin: 0; }
.docs-sidebar a.doc-link {
  display: block;
  color: var(--p-green-400);
  text-decoration: none;
  padding: 3px 8px;
  border-left: 2px solid transparent;
  transition: color 80ms, border-color 80ms, background 80ms;
  letter-spacing: 0.06em;
}
.docs-sidebar a.doc-link:hover {
  color: var(--p-green-200);
  background: rgba(60,255,122,0.04);
}
.docs-sidebar a.doc-link.active {
  color: var(--p-green-100);
  border-left-color: var(--p-green-300);
  background: rgba(60,255,122,0.06);
  text-shadow: 0 0 4px var(--p-green-glow);
}
.kbd {
  display: inline-block;
  padding: 0 4px;
  border: 1px solid var(--line);
  background: rgba(0,0,0,0.6);
  color: var(--p-green-500);
  font-size: 10px;
  letter-spacing: 0;
}

/* off-canvas drawer below 900px */
#navToggle { display: none; }
.drawer-scrim {
  position: fixed;
  inset: 0;
  z-index: 60;
  background: rgba(0,0,0,0.6);
  display: none;
}
@media (max-width: 900px) {
  #navToggle { display: inline-flex; }
  .docs-sidebar {
    position: fixed;
    top: 0; bottom: 0; left: 0;
    width: min(320px, 85vw);
    z-index: 70;
    background: #05100a;
    border-right: 1px solid var(--p-green-500);
    box-shadow: 12px 0 40px rgba(0,0,0,0.7);
    transform: translateX(calc(-100% - 40px));
    transition: transform 200ms var(--ease-snap);
    padding: 20px 16px 32px;
    font-size: 14px;
  }
  .docs-sidebar a.doc-link { padding: 8px 10px; }
  body.nav-open .docs-sidebar { transform: none; }
  body.nav-open .drawer-scrim { display: block; }
}

/* ───────────────── content */
.docs-content {
  overflow-y: auto;
  height: 100%;
  position: relative;
  background: #1a1d22;
  -webkit-overflow-scrolling: touch;
}
.docs-content .docs-meta {
  display: flex;
  gap: 10px 14px;
  align-items: center;
  flex-wrap: wrap;
  padding: 14px clamp(16px, 4vw, 64px) 0;
  margin: 0 auto;
  max-width: 1100px;
  font: 10px var(--font-mono);
  letter-spacing: 0.20em;
  text-transform: uppercase;
  color: var(--line);
}
.docs-content .docs-meta .chip {
  padding: 2px 8px;
  border: 1px solid var(--line);
  color: var(--p-green-500);
}
.docs-content .docs-meta .filename { color: var(--p-green-200); text-shadow: 0 0 4px var(--p-green-glow); word-break: break-all; }

/* mobile "on this page" disclosure (replaces the right-rail TOC) */
.toc-mobile {
  display: none;
  margin: 14px auto 0;
  max-width: 1100px;
  padding: 0 clamp(16px, 4vw, 64px);
}
@media (max-width: 1200px) {
  .toc-mobile.has-toc { display: block; }
}
.toc-mobile details {
  border: 1px solid #2f333d;
  background: #20232a;
  border-radius: 4px;
}
.toc-mobile summary {
  cursor: pointer;
  list-style: none;
  padding: 9px 14px;
  font: 10px var(--font-mono);
  letter-spacing: 0.22em;
  text-transform: uppercase;
  color: #9aa0a8;
  user-select: none;
}
.toc-mobile summary::-webkit-details-marker { display: none; }
.toc-mobile summary::before { content: "▸ "; color: #6b6f78; }
.toc-mobile details[open] summary::before { content: "▾ "; }
.toc-mobile ul { list-style: none; margin: 0; padding: 2px 14px 12px; }
.toc-mobile a {
  display: block;
  padding: 5px 0;
  color: #c4c8cf;
  text-decoration: none;
  font: 13.5px -apple-system, "Segoe UI", sans-serif;
  border-bottom: none;
}
.toc-mobile a:active { color: #fff; }
.toc-mobile li.lvl-2 a { padding-left: 14px; }
.toc-mobile li.lvl-3 a { padding-left: 26px; font-size: 12.5px; color: #9aa0a8; }
.toc-mobile li.lvl-4 a { padding-left: 38px; font-size: 12px; color: #6b6f78; }

/* prev/next nav */
.docs-nav {
  display: flex;
  justify-content: space-between;
  gap: 16px;
  padding: 24px clamp(16px, 4vw, 64px) 48px;
  max-width: 1100px;
  margin: 32px auto 0;
  border-top: 1px dashed var(--line);
}
.docs-nav a {
  flex: 1;
  min-width: 0;
  padding: 10px 14px;
  border: 1px solid var(--line);
  color: var(--p-green-400);
  text-decoration: none;
  background: rgba(0,0,0,0.4);
  font: 12px var(--font-mono);
  letter-spacing: 0.08em;
  transition: border-color 100ms, color 100ms;
}
.docs-nav a:hover {
  border-color: var(--p-green-400);
  color: var(--p-green-200);
  text-shadow: 0 0 4px var(--p-green-glow);
}
.docs-nav a.next { text-align: right; }
.docs-nav .label {
  display: block;
  font-size: 10px;
  letter-spacing: 0.22em;
  color: var(--line);
  margin-bottom: 4px;
  text-transform: uppercase;
}
.docs-nav .name {
  display: block;
  font-size: 13px;
  color: var(--p-green-200);
  letter-spacing: 0.12em;
  overflow: hidden;
  text-overflow: ellipsis;
  white-space: nowrap;
}
.docs-nav a.disabled { opacity: 0.2; pointer-events: none; }

/* ───────────────── right rail (TOC) */
.docs-toc {
  border-left: 1px solid var(--line);
  background: rgba(0, 0, 0, 0.3);
  padding: 20px 14px;
  overflow-y: auto;
  height: 100%;
  font: 11px var(--font-mono);
  letter-spacing: 0.04em;
}
.docs-toc h3 {
  font-size: 10px;
  letter-spacing: 0.24em;
  text-transform: uppercase;
  color: var(--p-green-500);
  margin: 0 0 10px;
  padding-bottom: 6px;
  border-bottom: 1px dashed var(--line);
}
.docs-toc ul { list-style: none; padding: 0; margin: 0; }
.docs-toc a {
  display: block;
  color: var(--p-green-500);
  text-decoration: none;
  padding: 2px 8px;
  border-left: 2px solid transparent;
  line-height: 1.4;
  transition: color 80ms, border-color 80ms;
}
.docs-toc a:hover { color: var(--p-green-200); }
.docs-toc a.active {
  color: var(--p-green-200);
  border-left-color: var(--p-green-300);
  text-shadow: 0 0 4px var(--p-green-glow);
}
.docs-toc li.lvl-2 a { padding-left: 18px; }
.docs-toc li.lvl-3 a { padding-left: 28px; font-size: 10.5px; }
.docs-toc li.lvl-4 a { padding-left: 36px; font-size: 10px; color: var(--line); }
.docs-toc .empty { color: var(--line); padding: 0 8px; font-style: normal; }

/* ───────────────── article body — readable reader surface
   The cockpit voice (Glass TTY, caps, phosphor) stays on the chrome;
   long-form prose gets a conventional dark-reader treatment. */
.md {
  --reader-fg:        #e2e5ea;
  --reader-fg-strong: #f4f5f7;
  --reader-muted:     #9aa0a8;
  --reader-accent:    #7ab7ff;
  --reader-accent-2:  #5aa0e8;
  --reader-border:    #2f333d;
  --reader-border-2:  #3a3f4b;
  --reader-panel:     #20232a;
  --reader-code-bg:   #15171c;
  --reader-callout:   #2a323d;

  max-width: 1100px;
  margin: 0 auto;
  padding: 28px clamp(16px, 4vw, 64px) 48px;
  font-family: -apple-system, BlinkMacSystemFont, "Segoe UI Variable",
               "Segoe UI", "Inter", Roboto, "Helvetica Neue", Arial, sans-serif;
  font-size: clamp(15px, 1.5vw, 15.5px);
  line-height: 1.7;
  letter-spacing: 0;
  color: var(--reader-fg);
  text-shadow: none;
  overflow-wrap: break-word;
}

.md h1, .md h2, .md h3, .md h4, .md h5, .md h6 {
  font-family: inherit;
  font-weight: 600;
  text-transform: none;
  letter-spacing: -0.005em;
  text-shadow: none;
  color: var(--reader-fg-strong);
  margin: 30px 0 12px;
  line-height: 1.3;
  position: relative;
  scroll-margin-top: 16px;
}
.md h1 {
  font-size: clamp(24px, 5vw, 30px);
  letter-spacing: -0.015em;
  margin-top: 0;
  padding-bottom: 10px;
  border-bottom: 1px solid var(--reader-border-2);
}
.md h2 {
  font-size: clamp(19px, 4vw, 22px);
  padding-bottom: 6px;
  border-bottom: 1px solid var(--reader-border);
}
.md h3 { font-size: 17px; color: var(--reader-accent); }
.md h4 {
  font-size: 14px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  color: var(--reader-muted);
}

.md p { margin: 12px 0; }
.md strong { color: var(--reader-fg-strong); font-weight: 600; }
.md em { font-style: italic; }

.md a {
  color: var(--reader-accent);
  text-decoration: none;
  border-bottom: 1px dotted var(--reader-accent-2);
  text-shadow: none;
}
.md a:hover {
  color: var(--reader-fg-strong);
  border-bottom-style: solid;
}

.md code {
  font-family: "Cascadia Mono", "JetBrains Mono", "Fira Code", Consolas, monospace;
  font-size: 0.88em;
  background: var(--reader-code-bg);
  color: #e8b894;
  padding: 1.5px 6px;
  border: 1px solid var(--reader-border);
}
.md pre {
  position: relative;
  background: var(--reader-code-bg);
  border: 1px solid var(--reader-border);
  border-radius: 6px;
  padding: 14px 16px;
  margin: 14px 0;
  overflow-x: auto;
  font-size: 13px;
  line-height: 1.55;
}
.md pre code {
  background: transparent;
  border: none;
  padding: 0;
  color: var(--reader-fg);
  font-size: inherit;
}
.codehilite { background: transparent !important; }

.md ul, .md ol { padding-left: 24px; margin: 12px 0; }
.md li { margin: 4px 0; }
.md ul li::marker { color: var(--reader-muted); content: "• "; }
.md ol li::marker { color: var(--reader-muted); content: counter(list-item) ". "; }

.md blockquote {
  margin: 14px 0;
  padding: 8px 16px;
  background: var(--reader-callout);
  border-left: 3px solid var(--reader-accent);
  color: var(--reader-fg);
  border-radius: 0 4px 4px 0;
}
.md blockquote p:first-child { margin-top: 0; }
.md blockquote p:last-child { margin-bottom: 0; }

.md hr {
  border: none;
  border-top: 1px solid var(--reader-border);
  margin: 26px 0;
}

/* wide tables scroll inside their own container on narrow screens */
.md .table-wrap { overflow-x: auto; margin: 16px 0; }
.md table {
  width: 100%;
  border-collapse: collapse;
  margin: 16px 0;
  font-size: 13.5px;
}
.md .table-wrap table { margin: 0; }
.md table th, .md table td {
  border: 1px solid var(--reader-border);
  padding: 7px 11px;
  text-align: left;
  vertical-align: top;
  background: transparent;
  color: var(--reader-fg);
  letter-spacing: 0;
}
.md table th {
  background: var(--reader-panel);
  color: var(--reader-fg-strong);
  font-weight: 600;
  text-transform: none;
}
.md table tr:nth-child(even) td { background: rgba(255,255,255,0.015); }

.md img { max-width: 100%; }

/* anchor pilcrow on headings */
.md .heading-anchor {
  position: absolute;
  left: -22px;
  top: 0; bottom: 0;
  width: 22px;
  opacity: 0;
  color: #6b6f78;
  text-decoration: none;
  border-bottom: none;
  font-size: 14px;
  display: flex; align-items: center;
  transition: opacity 80ms, color 80ms;
}
.md h1:hover .heading-anchor,
.md h2:hover .heading-anchor,
.md h3:hover .heading-anchor,
.md h4:hover .heading-anchor { opacity: 1; }
.md .heading-anchor:hover { color: #7ab7ff !important; border-bottom: none; }
@media (max-width: 720px) {
  .md .heading-anchor { display: none; }
}

/* copy buttons on code fences */
.copy-btn {
  position: absolute;
  top: 6px; right: 6px;
  padding: 2px 8px;
  font: 10px var(--font-mono);
  letter-spacing: 0.2em;
  text-transform: uppercase;
  background: rgba(0,0,0,0.7);
  color: var(--p-green-500);
  border: 1px solid var(--line);
  cursor: pointer;
  opacity: 0;
  transition: opacity 100ms, color 100ms, border-color 100ms;
}
.md pre:hover .copy-btn { opacity: 1; }
.copy-btn:hover { color: var(--p-green-200); border-color: var(--p-green-400); }
.copy-btn.copied { color: var(--cyan-300); border-color: var(--cyan-400); opacity: 1; }
@media (hover: none) {
  .copy-btn { opacity: 1; }
}

/* progress bar (reading position) */
#progress {
  position: sticky;
  top: 0;
  height: 1px;
  z-index: 5;
  pointer-events: none;
}
#progress > div {
  height: 100%;
  width: 0;
  background: var(--p-green-300);
  box-shadow: 0 0 4px var(--p-green-glow);
  transition: width 80ms linear;
}

/* ───────────────── global search palette (Ctrl/Cmd+Shift+F or ⌕ button) */
.search-overlay {
  position: fixed;
  inset: 0;
  z-index: 80;
  display: none;
  justify-content: center;
  align-items: flex-start;
  padding: 8vh 12px 12px;
  background: rgba(0,0,0,0.55);
  backdrop-filter: blur(2px);
}
.search-overlay.open { display: flex; }
.search-box {
  width: min(720px, 96vw);
  max-height: 80vh;
  display: flex;
  flex-direction: column;
  background: #14171c;
  border: 1px solid var(--line);
  box-shadow: 0 0 0 1px rgba(0,0,0,0.6), 0 24px 60px rgba(0,0,0,0.6);
}
.search-head {
  display: flex;
  align-items: center;
  gap: 10px;
  padding: 12px 14px;
  border-bottom: 1px solid var(--line);
}
.search-head .glyph { color: var(--p-green-500); font: 13px var(--font-mono); }
.search-input {
  flex: 1;
  min-width: 0;
  background: transparent;
  border: none;
  outline: none;
  color: var(--p-green-200);
  font: 15px var(--font-mono);
  letter-spacing: 0.04em;
}
.search-input::placeholder { color: var(--line); }
.search-head .hint { font: 10px var(--font-mono); letter-spacing: 0.14em; color: var(--line); white-space: nowrap; }
@media (max-width: 720px) {
  .search-overlay { padding-top: 12px; }
  .search-head .hint { display: none; }
}
.search-results { overflow-y: auto; padding: 6px 0; }
.search-results .status {
  padding: 14px 16px;
  font: 12px var(--font-mono);
  letter-spacing: 0.08em;
  color: var(--p-green-700);
  border: none;
  background: none;
  text-transform: none;
}
.search-doc {
  padding: 8px 16px 6px;
  font: 10px var(--font-mono);
  letter-spacing: 0.18em;
  text-transform: uppercase;
  color: var(--p-green-500);
  border-top: 1px dashed rgba(60,255,122,0.12);
}
.search-doc .count { color: var(--line); }
.search-hit {
  display: block;
  padding: 6px 16px 6px 22px;
  color: #c4c8cf;
  text-decoration: none;
  font: 13px -apple-system, "Segoe UI", sans-serif;
  line-height: 1.5;
  border-left: 2px solid transparent;
  cursor: pointer;
  white-space: nowrap;
  overflow: hidden;
  text-overflow: ellipsis;
}
.search-hit .ell { color: var(--p-green-700); }
.search-hit mark {
  background: #ffd76a;
  color: #14171c;
  padding: 0 1px;
  border-radius: 1px;
}
.search-hit:hover,
.search-hit.sel {
  background: rgba(60,255,122,0.07);
  border-left-color: var(--p-green-300);
  color: #eef0f3;
}

/* in-body hit highlight + navigator pill when arriving via ?q= */
.md mark.find-hit { background: #ffd76a; color: #14171c; padding: 0 1px; }
.md mark.find-hit.current { background: #ff9d3d; box-shadow: 0 0 0 2px rgba(255,157,61,0.4); }
.find-nav {
  position: fixed;
  bottom: calc(var(--status-h, 36px) + 16px);
  right: 16px;
  z-index: 40;
  display: none;
  align-items: center;
  gap: 8px;
  padding: 6px 10px;
  background: #14171c;
  border: 1px solid var(--line);
  box-shadow: 0 8px 24px rgba(0,0,0,0.5);
  font: 11px var(--font-mono);
  letter-spacing: 0.08em;
  color: var(--p-green-300);
}
.find-nav.open { display: flex; }
.find-nav .term { color: #ffd76a; max-width: 30vw; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; display: inline-block; vertical-align: bottom; }
.find-nav button {
  background: rgba(0,0,0,0.4);
  border: 1px solid var(--line);
  color: var(--p-green-400);
  cursor: pointer;
  padding: 1px 9px;
  font: 14px var(--font-mono);
  line-height: 1.5;
}
.find-nav button:hover { color: var(--p-green-200); border-color: var(--p-green-400); }