/* =========================================================================
   SoftFarm docs — layout on top of site.css
   ========================================================================= */

.docs-shell {
  display: grid;
  grid-template-columns: 258px minmax(0, 1fr) 218px;
  gap: clamp(1.5rem, 3vw, 3rem);
  max-width: 1360px;
  margin-inline: auto;
  padding-inline: clamp(1.1rem, 3vw, 2rem);
  align-items: start;
}
@media (max-width: 1240px) { .docs-shell { grid-template-columns: 240px minmax(0, 1fr); } .docs-toc { display: none; } }
@media (max-width: 1080px) { .docs-shell { grid-template-columns: minmax(0, 1fr); } }

/* ------------------------------ Sidebar --------------------------------- */
.docs-sidebar {
  position: sticky; top: 68px;
  max-height: calc(100vh - 68px);
  overflow-y: auto;
  padding: 1.8rem .4rem 3rem 0;
  scrollbar-width: thin;
}
.docs-sidebar::-webkit-scrollbar { width: 7px; }
.docs-sidebar::-webkit-scrollbar-thumb { background: var(--line-strong); border-radius: 4px; }

.doc-filter {
  width: 100%; font: inherit; font-size: .88rem;
  padding: .5rem .7rem .5rem 2rem;
  border: 1px solid var(--line); border-radius: 9px;
  background: var(--surface) url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='%236B7873' stroke-width='2.2' stroke-linecap='round'%3E%3Ccircle cx='11' cy='11' r='7'/%3E%3Cpath d='m20 20-3.6-3.6'/%3E%3C/svg%3E") no-repeat .55rem 50% / 14px;
  color: var(--ink);
  margin-bottom: 1.4rem;
}
.doc-filter::placeholder { color: var(--ink-3); }
.doc-filter:focus { border-color: var(--accent); outline: none; box-shadow: 0 0 0 3px color-mix(in srgb, var(--accent) 18%, transparent); }

.docs-nav-group + .docs-nav-group { margin-top: 1.5rem; }
.docs-nav-group > h5 {
  font-family: var(--font-sans); font-size: .7rem; font-weight: 680;
  text-transform: uppercase; letter-spacing: .11em; color: var(--ink-3);
  margin: 0 0 .55rem .7rem;
}
.docs-nav { list-style: none; margin: 0; padding: 0; display: grid; gap: 1px; }
.docs-nav a {
  display: block; padding: .42rem .7rem; border-radius: 8px;
  font-size: .905rem; color: var(--ink-2); text-decoration: none; line-height: 1.45;
  border-left: 2px solid transparent;
  transition: color .14s ease, background .14s ease;
}
.docs-nav a:hover { color: var(--ink); background: var(--surface-2); }
.docs-nav a.is-active {
  color: var(--accent); font-weight: 620;
  background: color-mix(in srgb, var(--accent) 10%, transparent);
}

@media (max-width: 1080px) {
  .docs-sidebar {
    position: fixed; inset: 68px auto 0 0; z-index: 55; width: min(300px, 84vw);
    background: var(--surface); border-right: 1px solid var(--line);
    padding: 1.3rem 1rem 3rem; max-height: none; height: calc(100vh - 68px);
    transform: translateX(-102%); transition: transform .22s ease; box-shadow: var(--shadow-lg);
  }
  .docs-sidebar.is-open { transform: none; }
  body.nav-locked { overflow: hidden; }
}

.sidebar-toggle { display: none; }
@media (max-width: 1080px) {
  .sidebar-toggle {
    display: inline-flex; align-items: center; gap: .45rem;
    position: sticky; top: 68px; z-index: 40;
    margin: 0 0 1.2rem; padding: .5rem .85rem;
    background: var(--surface); border: 1px solid var(--line); border-radius: 999px;
    font: inherit; font-size: .85rem; font-weight: 600; color: var(--ink-2); cursor: pointer;
  }
}

/* ------------------------------ Article ---------------------------------- */
.doc-main { padding: 1.8rem 0 4.5rem; min-width: 0; }

.breadcrumb { font-size: .82rem; color: var(--ink-3); margin-bottom: .9rem; }
.breadcrumb a { color: var(--ink-3); text-decoration: none; }
.breadcrumb a:hover { color: var(--accent); }
.breadcrumb span { margin-inline: .4rem; opacity: .55; }

.doc-title { font-size: clamp(2rem, 1.5rem + 1.9vw, 2.85rem); margin-bottom: .3em; letter-spacing: -.028em; }
.doc-sub { font-size: 1.08rem; color: var(--ink-2); margin-bottom: 2.4rem; max-width: 66ch; }

/* Prose is capped for readability; tables, code and diagrams use the full column. */
.doc-body { max-width: 940px; }
.doc-body > p, .doc-body > ul, .doc-body > ol, .doc-body > .callout { max-width: 74ch; }
.doc-body > h2, .doc-body > h3 { max-width: none; }
.doc-body > h2 {
  font-size: clamp(1.45rem, 1.25rem + .8vw, 1.85rem);
  margin-top: 3rem; margin-bottom: .7rem;
  padding-top: 1.6rem; border-top: 1px solid var(--line);
}
.doc-body > h2:first-child { margin-top: 0; padding-top: 0; border-top: 0; }
.doc-body > h3 { font-size: 1.18rem; margin-top: 2.1rem; margin-bottom: .5rem; }
.doc-body > h4 { font-size: 1rem; margin-top: 1.6rem; margin-bottom: .4rem; color: var(--ink); }
.doc-body p, .doc-body li { color: var(--ink-2); }
.doc-body > p { margin-bottom: 1.15rem; }
.doc-body ul, .doc-body ol { padding-left: 1.25rem; margin: 0 0 1.3rem; }
.doc-body li { margin-bottom: .45rem; }
.doc-body li::marker { color: var(--ink-3); }
.doc-body strong { color: var(--ink); font-weight: 620; }

/* Anchor links on headings */
.doc-body h2, .doc-body h3 { scroll-margin-top: 92px; position: relative; }
.doc-body h2 > .anchor, .doc-body h3 > .anchor {
  position: absolute; left: -1.15rem; opacity: 0; text-decoration: none;
  color: var(--ink-3); font-weight: 400;
}
.doc-body h2:hover > .anchor, .doc-body h3:hover > .anchor { opacity: 1; }

/* pre + copy button */
.doc-body pre { position: relative; }
.copy-btn {
  position: absolute; top: .5rem; right: .5rem;
  font: inherit; font-size: .7rem; font-weight: 600; font-family: var(--font-sans);
  padding: .28rem .58rem; border-radius: 6px; cursor: pointer;
  background: rgba(255,255,255,.09); color: #BCD5C9;
  border: 1px solid rgba(255,255,255,.16);
  opacity: 0; transition: opacity .15s ease, background .15s ease, color .15s ease;
}
.doc-body pre:hover .copy-btn, .copy-btn:focus-visible { opacity: 1; }
.copy-btn:hover { background: rgba(255,255,255,.18); color: #FFFFFF; }

/* --------------------------- API endpoint rows ---------------------------- */
.endpoint {
  display: flex; flex-wrap: wrap; align-items: baseline; gap: .6rem;
  font-family: var(--font-mono); font-size: .855rem;
  padding: .62rem .85rem; margin-bottom: .5rem;
  background: var(--surface); border: 1px solid var(--line); border-radius: var(--radius-sm);
}
.endpoint .path { color: var(--ink); font-weight: 500; word-break: break-all; }
.endpoint .desc { font-family: var(--font-sans); font-size: .84rem; color: var(--ink-3); margin-left: auto; }
.method {
  font-size: .66rem; font-weight: 800; letter-spacing: .07em;
  padding: .2rem .45rem; border-radius: 5px; flex: none;
}
.m-get    { color: #1B6FB8; background: #E3EFFA; }
.m-post   { color: var(--safe); background: var(--safe-bg); }
.m-put    { color: var(--risky); background: var(--risky-bg); }
.m-patch  { color: var(--gold-600); background: var(--gold-100); }
.m-delete { color: var(--blocked); background: var(--blocked-bg); }
:root[data-theme="dark"] .m-get, :root:not([data-theme="light"]) .m-get { color: #7CB9EC; background: #13293C; }
@media (prefers-color-scheme: light) { :root:not([data-theme="dark"]) .m-get { color:#1B6FB8; background:#E3EFFA; } }

/* --------------------------- Right-hand TOC ------------------------------- */
.docs-toc { position: sticky; top: 68px; padding: 2.4rem 0 3rem; max-height: calc(100vh - 68px); overflow-y: auto; }
.docs-toc > h5 {
  font-family: var(--font-sans); font-size: .7rem; font-weight: 680; text-transform: uppercase;
  letter-spacing: .11em; color: var(--ink-3); margin: 0 0 .7rem;
}
.docs-toc ul { list-style: none; margin: 0; padding: 0; display: grid; gap: 1px; border-left: 1px solid var(--line); }
.docs-toc a {
  display: block; padding: .3rem 0 .3rem .8rem; margin-left: -1px;
  border-left: 2px solid transparent;
  font-size: .845rem; line-height: 1.4; color: var(--ink-3); text-decoration: none;
}
.docs-toc a:hover { color: var(--ink); }
.docs-toc a.is-active { color: var(--accent); border-left-color: var(--accent); font-weight: 580; }
.docs-toc .toc-sub a { padding-left: 1.6rem; font-size: .81rem; }

/* ------------------------------ Doc footer -------------------------------- */
.doc-nav-pair { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(min(100%, 230px), 1fr)); margin-top: 3.5rem; padding-top: 1.8rem; border-top: 1px solid var(--line); }
.doc-nav-pair a {
  display: block; padding: .95rem 1.1rem; border: 1px solid var(--line); border-radius: var(--radius);
  text-decoration: none; background: var(--surface); transition: border-color .16s ease;
}
.doc-nav-pair a:hover { border-color: var(--accent); }
.doc-nav-pair small { display: block; font-size: .74rem; text-transform: uppercase; letter-spacing: .09em; color: var(--ink-3); margin-bottom: .2rem; }
.doc-nav-pair b { color: var(--ink); font-weight: 600; font-size: .96rem; }
.doc-nav-pair .next { text-align: right; }

/* Docs index cards */
.doc-cards { display: grid; gap: 1rem; grid-template-columns: repeat(auto-fit, minmax(min(100%, 250px), 1fr)); margin-bottom: 1rem; }
.doc-card {
  display: block; text-decoration: none; color: inherit;
  padding: 1.25rem 1.3rem; border: 1px solid var(--line); border-radius: var(--radius);
  background: var(--surface); transition: border-color .16s ease, transform .16s ease;
}
.doc-card:hover { border-color: var(--accent); transform: translateY(-2px); }
.doc-card b { display: block; font-weight: 640; margin-bottom: .28rem; color: var(--ink); }
.doc-card span { font-size: .88rem; color: var(--ink-3); line-height: 1.5; display: block; }

/* Definition-style key/value list */
.kv { display: grid; gap: 0; margin: 0 0 1.5rem; border: 1px solid var(--line); border-radius: var(--radius); overflow: hidden; }
.kv > div { display: grid; grid-template-columns: minmax(150px, 220px) 1fr; gap: 1rem; padding: .75rem 1rem; background: var(--surface); border-bottom: 1px solid var(--line); }
.kv > div:last-child { border-bottom: 0; }
.kv dt { font-family: var(--font-mono); font-size: .82rem; color: var(--ink); word-break: break-word; }
.kv dd { margin: 0; font-size: .9rem; color: var(--ink-2); }
@media (max-width: 620px) { .kv > div { grid-template-columns: 1fr; gap: .2rem; } }

.doc-filter-empty { margin: -.9rem .7rem 1.4rem; font-size: .85rem; color: var(--ink-3); }

/* ============================ User-manual bits ============================= */

/* "Where to find it" line under a heading */
.where {
  display: flex; flex-wrap: wrap; align-items: center; gap: .4rem;
  font-size: .85rem; color: var(--ink-3);
  background: var(--surface-2); border: 1px solid var(--line);
  border-radius: var(--radius-sm); padding: .6rem .85rem; margin: 0 0 1.4rem;
}
.where b { color: var(--ink); font-weight: 600; }
.where svg { width: 15px; height: 15px; flex: none; opacity: .7; }
.where .sep { opacity: .5; }

/* Numbered task steps */
.task { list-style: none; counter-reset: task; padding: 0; margin: 0 0 1.6rem; max-width: 74ch; }
.task > li {
  counter-increment: task; position: relative;
  padding: 0 0 1.1rem 2.6rem; margin: 0;
}
.task > li::before {
  content: counter(task); position: absolute; left: 0; top: -.1rem;
  width: 26px; height: 26px; border-radius: 50%;
  display: grid; place-items: center;
  background: var(--accent); color: var(--accent-ink);
  font-size: .8rem; font-weight: 700; font-variant-numeric: tabular-nums;
}
.task > li::after {
  content: ""; position: absolute; left: 13px; top: 30px; bottom: .25rem;
  width: 1px; background: var(--line);
}
.task > li:last-child { padding-bottom: 0; }
.task > li:last-child::after { display: none; }
.task > li > b:first-child { color: var(--ink); font-weight: 640; }
.task ul { margin: .5rem 0 0; padding-left: 1.1rem; }

/* Audience badge */
.audience {
  display: inline-flex; align-items: center; gap: .4rem;
  font-size: .72rem; font-weight: 700; letter-spacing: .09em; text-transform: uppercase;
  padding: .28rem .6rem; border-radius: 999px; margin-bottom: 1rem;
  background: var(--green-100); color: var(--green-600);
}
.audience-exporter { background: var(--gold-100); color: var(--gold-600); }
:root[data-theme="dark"] .audience, :root:not([data-theme="light"]) .audience { color: var(--accent); }
:root[data-theme="dark"] .audience-exporter, :root:not([data-theme="light"]) .audience-exporter { color: var(--gold-500); }
@media (prefers-color-scheme: light) {
  :root:not([data-theme="dark"]) .audience { color: var(--green-600); }
  :root:not([data-theme="dark"]) .audience-exporter { color: var(--gold-600); }
}

/* Two big choice cards on the guide index */
.choose { display: grid; gap: 1.1rem; grid-template-columns: repeat(auto-fit, minmax(min(100%, 270px), 1fr)); margin: 0 0 2rem; }
.choose a {
  display: block; text-decoration: none; color: inherit;
  border: 1px solid var(--line); border-radius: var(--radius);
  background: var(--surface); padding: 1.5rem 1.5rem 1.6rem;
  transition: border-color .16s ease, transform .16s ease;
}
.choose a:hover { border-color: var(--accent); transform: translateY(-2px); }
.choose h3 { margin: .7rem 0 .4rem; font-size: 1.2rem; }
.choose p { margin: 0 0 1rem; font-size: .93rem; color: var(--ink-2); }
.choose ul { margin: 0; padding-left: 1.1rem; font-size: .89rem; color: var(--ink-3); }
.choose li { margin-bottom: .3rem; }