/* RoughCut documentation layer — loaded after style.css (and after ar.css on /ar/).
   Written with CSS logical properties throughout, so the same rules mirror
   correctly under dir="rtl" without a parallel Arabic stylesheet. */

.docs-body {
  --docs-sidebar: 260px;
  --docs-measure: 76ch;
}

.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  margin: -1px;
  padding: 0;
  overflow: hidden;
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}

/* ---------- Shell ---------- */

.docs-shell {
  display: grid;
  grid-template-columns: var(--docs-sidebar) minmax(0, 1fr);
  gap: 2.5rem;
  max-width: var(--w);
  margin: 0 auto;
  padding: 1.5rem 1.25rem 5rem;
  align-items: start;
}

.docs-main {
  min-width: 0;
}

/* ---------- Sidebar ---------- */

.docs-sidebar {
  position: sticky;
  top: 84px;
  max-height: calc(100vh - 104px);
  overflow-y: auto;
  overscroll-behavior: contain;
  padding-inline-end: 0.5rem;
  font-size: 0.94rem;
}

.docs-sidebar-home {
  display: block;
  padding: 0.5rem 0.75rem;
  margin-block-end: 0.75rem;
  border-radius: 10px;
  border: 1px solid var(--line);
  color: var(--text);
  text-decoration: none;
  font-weight: 600;
}

.docs-sidebar-home:hover,
.docs-sidebar-home[aria-current="page"] {
  background: var(--violet-soft);
  border-color: var(--line-strong);
}

.docs-nav,
.docs-nav ul {
  list-style: none;
}

.docs-nav-group + .docs-nav-group {
  margin-block-start: 1.35rem;
}

.docs-nav-heading {
  font-family: var(--font-body);
  font-size: 0.72rem;
  font-weight: 600;
  letter-spacing: 0.09em;
  text-transform: uppercase;
  color: var(--faint);
  margin-block-end: 0.45rem;
  padding-inline-start: 0.75rem;
}

.docs-nav a {
  display: block;
  padding: 0.3rem 0.75rem;
  border-inline-start: 2px solid transparent;
  color: var(--muted);
  text-decoration: none;
  line-height: 1.45;
}

.docs-nav a:hover {
  color: var(--text);
  border-inline-start-color: var(--line-strong);
}

.docs-nav a[aria-current="page"] {
  color: var(--amber);
  border-inline-start-color: var(--amber);
  font-weight: 600;
}

/* ---------- Search ---------- */

.docs-search {
  position: relative;
  margin-block-end: 1.5rem;
}

.docs-search input {
  width: 100%;
  padding: 0.7rem 1rem;
  border-radius: 12px;
  border: 1px solid var(--line);
  background: var(--surface);
  color: var(--text);
  font-family: inherit;
  font-size: 1rem;
}

.docs-search input:focus-visible {
  outline: 2px solid var(--amber);
  outline-offset: 2px;
  border-color: var(--line-strong);
}

.docs-search-status {
  margin-block-start: 0.4rem;
  font-size: 0.85rem;
  color: var(--faint);
  min-height: 1.2em;
}

.docs-search-results {
  list-style: none;
  margin-block-start: 0.5rem;
  border: 1px solid var(--line);
  border-radius: 12px;
  background: var(--bg-raise);
  overflow: hidden;
}

.docs-search-results[hidden] {
  display: none;
}

.docs-search-results li + li {
  border-block-start: 1px solid var(--line);
}

.docs-search-results a {
  display: block;
  padding: 0.7rem 1rem;
  color: var(--text);
  text-decoration: none;
}

.docs-search-results a:hover,
.docs-search-results a:focus-visible {
  background: var(--violet-soft);
}

.docs-search-results strong {
  display: block;
  font-weight: 600;
}

.docs-search-results small {
  display: block;
  color: var(--faint);
  font-size: 0.84rem;
  margin-block-start: 0.15rem;
}

.docs-search-results em {
  font-style: normal;
  color: var(--amber);
}

/* ---------- Article ---------- */

.docs-breadcrumbs ol {
  display: flex;
  flex-wrap: wrap;
  gap: 0.4rem;
  list-style: none;
  font-size: 0.85rem;
  color: var(--faint);
  margin-block-end: 1.25rem;
}

.docs-breadcrumbs li + li::before {
  content: "/";
  margin-inline-end: 0.4rem;
  color: var(--line-strong);
}

.docs-breadcrumbs a {
  color: var(--muted);
  text-decoration: none;
}

.docs-breadcrumbs a:hover { color: var(--text); }

.docs-article {
  max-width: var(--docs-measure);
}

.docs-article h1 {
  font-family: var(--font-display);
  font-size: clamp(1.9rem, 4vw, 2.6rem);
  line-height: 1.2;
  margin-block-end: 0.6rem;
}

.docs-lede {
  font-size: 1.15rem;
  color: var(--muted);
  margin-block-end: 1.1rem;
}

.docs-meta {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem 1.1rem;
  font-size: 0.85rem;
  color: var(--faint);
  padding-block-end: 1.1rem;
  border-block-end: 1px solid var(--line);
  margin-block-end: 1.6rem;
}

.docs-meta strong { color: var(--muted); font-weight: 600; }
.docs-lang-link { color: var(--amber); text-decoration: none; }
.docs-lang-link:hover { text-decoration: underline; }

/* The extractable answer block. */
.docs-answer {
  border-inline-start: 3px solid var(--amber);
  background: var(--amber-soft);
  border-radius: 0 var(--radius) var(--radius) 0;
  padding: 1.05rem 1.25rem;
  margin-block-end: 1.75rem;
}

[dir="rtl"] .docs-answer {
  border-radius: var(--radius) 0 0 var(--radius);
}

.docs-answer p { margin: 0; }

/* ---------- Table of contents ---------- */

.docs-toc {
  border: 1px solid var(--line);
  border-radius: var(--radius);
  padding: 0.85rem 1.15rem;
  margin-block-end: 2rem;
  background: var(--bg-raise);
}

.docs-toc summary {
  cursor: pointer;
  font-weight: 600;
  font-size: 0.9rem;
  color: var(--muted);
}

.docs-toc ul {
  list-style: none;
  margin-block-start: 0.65rem;
  display: grid;
  gap: 0.3rem;
}

.docs-toc a {
  color: var(--muted);
  text-decoration: none;
  font-size: 0.95rem;
}

.docs-toc a:hover { color: var(--amber); }

/* ---------- Body copy ---------- */

.docs-body-copy,
.docs-article .docs-body { font-size: 1.0625rem; }

.docs-article .docs-body > * + * { margin-block-start: 1.05rem; }

.docs-article .docs-body h2 {
  font-family: var(--font-display);
  font-size: 1.5rem;
  line-height: 1.3;
  margin-block-start: 2.6rem;
  padding-block-start: 1.1rem;
  border-block-start: 1px solid var(--line);
}

.docs-article .docs-body h3 {
  font-size: 1.15rem;
  margin-block-start: 1.9rem;
}

.docs-article .docs-body h4 {
  font-size: 1rem;
  color: var(--muted);
  margin-block-start: 1.5rem;
}

.docs-article .docs-body ul,
.docs-article .docs-body ol {
  padding-inline-start: 1.4rem;
  display: grid;
  gap: 0.45rem;
}

.docs-article .docs-body li { padding-inline-start: 0.2rem; }

.docs-article .docs-body a { color: var(--amber); text-underline-offset: 3px; }
.docs-article .docs-body a:hover { color: var(--violet-bright); }

.docs-article code {
  font-family: var(--font-mono);
  font-size: 0.9em;
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: 6px;
  padding: 0.08em 0.35em;
  /* Labels, paths and model ids stay left-to-right inside Arabic prose. */
  unicode-bidi: isolate;
}

.docs-article pre {
  background: var(--surface);
  border: 1px solid var(--line);
  border-radius: var(--radius);
  padding: 1rem 1.15rem;
  overflow-x: auto;
  text-align: start;
}

.docs-article pre code {
  background: none;
  border: 0;
  padding: 0;
  font-size: 0.88rem;
  line-height: 1.6;
}

/* Wide tables scroll inside their own box; the page never scrolls sideways. */
.doc-table-scroll {
  overflow-x: auto;
  border: 1px solid var(--line);
  border-radius: var(--radius);
}

.docs-article table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.94rem;
}

.docs-article th,
.docs-article td {
  text-align: start;
  padding: 0.6rem 0.85rem;
  border-block-end: 1px solid var(--line);
  vertical-align: top;
}

.docs-article thead th {
  background: var(--surface);
  font-weight: 600;
  color: var(--text);
  white-space: nowrap;
}

.docs-article tbody tr:last-child td { border-block-end: 0; }

.doc-callout {
  border-inline-start: 3px solid var(--violet-bright);
  background: var(--violet-soft);
  padding: 0.9rem 1.15rem;
  border-radius: 0 12px 12px 0;
  color: var(--muted);
}

[dir="rtl"] .doc-callout { border-radius: 12px 0 0 12px; }

.doc-callout-caution {
  border-inline-start-color: var(--amber);
  background: var(--amber-soft);
}

.doc-figure {
  margin-block: 1.75rem;
}

.doc-figure img {
  width: 100%;
  height: auto;
  border-radius: var(--radius);
  border: 1px solid var(--line);
  display: block;
}

.doc-figure figcaption {
  margin-block-start: 0.6rem;
  font-size: 0.88rem;
  color: var(--faint);
}

.docs-article hr {
  border: 0;
  border-block-start: 1px solid var(--line);
  margin-block: 2rem;
}

/* ---------- Related, help, pager ---------- */

.docs-related,
.docs-help {
  margin-block-start: 3rem;
  padding-block-start: 1.5rem;
  border-block-start: 1px solid var(--line);
}

.docs-related h2,
.docs-help h2 {
  font-family: var(--font-display);
  font-size: 1.2rem;
  margin-block-end: 0.9rem;
}

.docs-related ul {
  list-style: none;
  display: grid;
  gap: 0.6rem;
  grid-template-columns: repeat(auto-fit, minmax(240px, 1fr));
}

.docs-related a {
  display: block;
  padding: 0.8rem 1rem;
  border: 1px solid var(--line);
  border-radius: 12px;
  text-decoration: none;
  color: var(--text);
  height: 100%;
}

.docs-related a:hover {
  border-color: var(--line-strong);
  background: var(--violet-soft);
}

.docs-related span { display: block; font-weight: 600; }
.docs-related small { display: block; color: var(--faint); margin-block-start: 0.2rem; font-size: 0.85rem; }

.docs-feedback {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  flex-wrap: wrap;
  margin-block-start: 1.1rem;
  font-size: 0.92rem;
  color: var(--muted);
}

.docs-feedback button {
  font: inherit;
  padding: 0.3rem 0.95rem;
  border-radius: 999px;
  border: 1px solid var(--line);
  background: transparent;
  color: var(--text);
  cursor: pointer;
}

.docs-feedback button:hover { border-color: var(--amber); color: var(--amber); }
.docs-feedback[data-done="true"] button { display: none; }

.docs-pager {
  display: flex;
  justify-content: space-between;
  gap: 1rem;
  margin-block-start: 2.5rem;
  padding-block-start: 1.5rem;
  border-block-start: 1px solid var(--line);
}

.docs-pager-link {
  display: block;
  max-width: 46%;
  text-decoration: none;
  color: var(--text);
}

.docs-pager-next { text-align: end; }
.docs-pager-link small { display: block; color: var(--faint); font-size: 0.78rem; }
.docs-pager-link span { font-weight: 600; }
.docs-pager-link:hover span { color: var(--amber); }

/* ---------- Documentation home cards ---------- */

.docs-article .docs-body > ul.docs-cards {
  grid-template-columns: repeat(auto-fit, minmax(230px, 1fr));
  padding-inline-start: 0;
  list-style: none;
}

/* ---------- Responsive ---------- */

@media (max-width: 900px) {
  .docs-shell {
    grid-template-columns: minmax(0, 1fr);
    gap: 1.25rem;
    padding-block-start: 1rem;
  }

  .docs-sidebar {
    position: static;
    max-height: none;
    order: 2;
    padding-block-start: 2rem;
    margin-block-start: 2rem;
    border-block-start: 1px solid var(--line);
  }

  .docs-main { order: 1; }

  .docs-pager { flex-direction: column; }
  .docs-pager-link { max-width: none; }
  .docs-pager-next { text-align: start; }
}

@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }
}