/* API guide. Same paper, ink and accent as landing.css and login.css; code
   is set left to right on dark ink so it reads like a terminal. */

:root {
  color-scheme: light;
  --bg: #f6f3ec;
  --bg-2: #ede8dc;
  --surface: #ffffff;
  --ink: #0e0e10;
  --ink-2: #45454d;
  --ink-3: #5e5e66;
  --line: rgba(14, 14, 16, 0.1);
  --line-strong: rgba(14, 14, 16, 0.24);
  --primary: #0e0e10;
  --on-primary: #f6f3ec;
  --accent: #4635d8;
  --accent-soft: #eeebff;
  --ok: #0d7343;
  --ok-soft: #e3f7ec;
  --warn-soft: #fff4d1;
  --code-bg: #16161a;
  --code-ink: #ececf1;
  --code-dim: #9a9aa6;
  --font: Vazirmatn, Tahoma, system-ui, sans-serif;
  --mono: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace;
  --radius: 14px;
  --radius-lg: 22px;
  --gutter: clamp(16px, 4vw, 40px);
  --toc: 240px;
  --top: 64px;
}

*, *::before, *::after { box-sizing: border-box; }

html { -webkit-text-size-adjust: 100%; scroll-padding-top: calc(var(--top) + 16px); }
@media (prefers-reduced-motion: no-preference) { html { scroll-behavior: smooth; } }

body {
  margin: 0;
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font);
  font-size: 16px;
  line-height: 1.9;
  -webkit-font-smoothing: antialiased;
}

a { color: var(--accent); text-underline-offset: 3px; }
a:hover { text-decoration-thickness: 2px; }

:focus-visible { outline: 3px solid var(--accent); outline-offset: 3px; border-radius: 6px; }

.skip {
  position: absolute;
  inset-inline-start: 16px;
  top: -60px;
  z-index: 20;
  padding: 8px 16px;
  border-radius: 999px;
  background: var(--primary);
  color: var(--on-primary);
}
.skip:focus { top: 12px; }

/* Top bar */
.topbar {
  position: sticky;
  top: 0;
  z-index: 10;
  background: rgba(246, 243, 236, 0.9);
  backdrop-filter: saturate(1.4) blur(10px);
  border-bottom: 1px solid var(--line);
}
.topbar__inner {
  max-width: 1240px;
  min-height: var(--top);
  margin: 0 auto;
  padding: 0 var(--gutter);
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 16px;
}
.brand { display: inline-flex; align-items: center; gap: 10px; color: var(--ink); font-weight: 800; text-decoration: none; white-space: nowrap; }
.brand__tag { padding: 0 8px; border-radius: 6px; background: var(--ink); color: var(--on-primary); font-size: 12px; line-height: 22px; font-weight: 700; }
.topbar__links { display: flex; align-items: center; gap: 4px; flex-wrap: wrap; justify-content: flex-end; }
.topbar__links a { padding: 6px 12px; border-radius: 999px; color: var(--ink-2); font-size: 14px; font-weight: 500; text-decoration: none; }
.topbar__links a:hover { background: var(--bg-2); color: var(--ink); }
.topbar__links .topbar__cta { background: var(--primary); color: var(--on-primary); }
.topbar__links .topbar__cta:hover { background: #2a2a30; color: var(--on-primary); }

/* Layout */
.layout {
  max-width: 1240px;
  margin: 0 auto;
  padding: 0 var(--gutter);
  display: grid;
  grid-template-columns: var(--toc) minmax(0, 1fr);
  gap: clamp(24px, 4vw, 56px);
}

.toc { padding-block: 32px; }
.toc__box { position: sticky; top: calc(var(--top) + 20px); }
.toc summary { font-weight: 700; font-size: 14px; color: var(--ink-3); cursor: pointer; list-style: none; margin-bottom: 8px; }
.toc summary::-webkit-details-marker { display: none; }
.toc ol { list-style: none; margin: 0; padding: 0; display: grid; gap: 2px; counter-reset: toc; }
.toc a {
  display: block;
  padding: 4px 12px;
  border-inline-start: 2px solid transparent;
  color: var(--ink-2);
  font-size: 14px;
  line-height: 1.7;
  text-decoration: none;
}
.toc a:hover { color: var(--ink); background: var(--bg-2); }
.toc a[aria-current="true"] { color: var(--accent); border-inline-start-color: var(--accent); font-weight: 700; }

.doc { min-width: 0; padding-block: 32px 80px; }
.doc section { padding-block: 28px; border-bottom: 1px solid var(--line); }
.doc section:last-child { border-bottom: 0; }

h1, h2, h3 { margin: 0; line-height: 1.35; color: var(--ink); }
h1 { font-size: clamp(30px, 5vw, 44px); font-weight: 800; letter-spacing: -0.01em; margin-block: 6px 16px; }
h2 { font-size: clamp(22px, 3vw, 28px); font-weight: 800; margin-bottom: 14px; }
h3, .h3 { font-size: 18px; font-weight: 700; margin-block: 22px 8px; }
p { margin: 0 0 12px; color: var(--ink-2); }
b { color: var(--ink); }

.eyebrow { margin: 0; color: var(--accent); font-weight: 700; font-size: 14px; }
.lede { font-size: 18px; line-height: 1.9; max-width: 68ch; }

.facts {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(170px, 1fr));
  gap: 10px;
  margin: 20px 0;
}
.facts div { min-width: 0; padding: 12px 14px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); }
.facts div:first-child { grid-column: 1 / -1; }
.facts dt { font-size: 13px; color: var(--ink-3); }
.facts dd { margin: 0; font-weight: 700; overflow-wrap: anywhere; }

.callout {
  margin: 16px 0;
  padding: 14px 16px;
  border-radius: var(--radius);
  background: var(--warn-soft);
  color: var(--ink);
  line-height: 1.8;
}

.flow, .steps, .list { margin: 0 0 12px; padding-inline-start: 22px; color: var(--ink-2); }
.flow li, .list li { margin-block: 6px; }
.steps { list-style: none; padding: 0; counter-reset: step; display: grid; grid-template-columns: minmax(0, 1fr); gap: 8px; }
.steps > li { position: relative; min-width: 0; padding-inline-start: 46px; counter-increment: step; }
.steps > li::before {
  content: counter(step, persian);
  position: absolute;
  inset-inline-start: 0;
  top: 18px;
  width: 30px;
  height: 30px;
  display: grid;
  place-items: center;
  border-radius: 50%;
  background: var(--ink);
  color: var(--on-primary);
  font-weight: 800;
  font-size: 14px;
}
.steps > li > h3 { margin-top: 20px; }

/* Code */
code {
  font-family: var(--mono);
  font-size: 0.88em;
  direction: ltr;
  unicode-bidi: isolate;
  padding: 1px 6px;
  border-radius: 6px;
  background: var(--bg-2);
  color: var(--ink);
}

pre {
  margin: 0;
  padding: 16px 18px;
  overflow-x: auto;
  direction: ltr;
  text-align: left;
  background: var(--code-bg);
  color: var(--code-ink);
  font-family: var(--mono);
  font-size: 13.5px;
  line-height: 1.7;
  tab-size: 2;
}
pre code { padding: 0; background: none; color: inherit; font-size: inherit; unicode-bidi: plaintext; }

.code-plain, .code {
  position: relative;
  margin: 12px 0 16px;
  border-radius: var(--radius);
  overflow: hidden;
}
/* A single block scrolls sideways; a tabbed one scrolls inside its pane. */
.code-plain { padding: 16px 18px; overflow-x: auto; }

.code { background: var(--code-bg); }
.code__tabs {
  display: flex;
  gap: 2px;
  padding: 8px 8px 0;
  direction: ltr;
  border-bottom: 1px solid rgba(255, 255, 255, 0.08);
  overflow-x: auto;
}
.code__tab {
  border: 0;
  padding: 6px 12px;
  border-radius: 8px 8px 0 0;
  background: transparent;
  color: var(--code-dim);
  font: 600 13px/1.4 var(--font);
  cursor: pointer;
}
.code__tab:hover { color: var(--code-ink); }
.code__tab[aria-selected="true"] { color: var(--code-ink); background: rgba(255, 255, 255, 0.08); }
.code pre[hidden] { display: none; }

.copy {
  position: absolute;
  top: 8px;
  right: 8px;
  z-index: 1;
  border: 1px solid rgba(255, 255, 255, 0.16);
  border-radius: 8px;
  padding: 2px 10px;
  background: rgba(22, 22, 26, 0.9);
  color: var(--code-dim);
  font: 500 12px/1.8 var(--font);
  cursor: pointer;
}
.copy:hover { color: var(--code-ink); border-color: rgba(255, 255, 255, 0.3); }

/* Tables */
.table-wrap { overflow-x: auto; margin: 12px 0 16px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); }
table { width: 100%; border-collapse: collapse; font-size: 14.5px; line-height: 1.7; }
caption { text-align: start; padding: 10px 14px 0; font-weight: 700; color: var(--ink-3); font-size: 13px; }
th, td { padding: 10px 14px; text-align: start; vertical-align: top; border-bottom: 1px solid var(--line); }
th { color: var(--ink-3); font-weight: 700; font-size: 13px; background: var(--bg); }
tr:last-child td { border-bottom: 0; }
td code { white-space: nowrap; }
.ref td:nth-child(2) code { white-space: nowrap; }

.verb {
  display: inline-block;
  min-width: 58px;
  padding: 0 8px;
  border-radius: 6px;
  background: var(--ok-soft);
  color: var(--ok);
  font: 700 12px/22px var(--mono);
  text-align: center;
  direction: ltr;
}
.verb--post { background: var(--accent-soft); color: var(--accent); }
.verb--put { background: var(--warn-soft); color: #7a5600; }
.verb--delete { background: #fdf0ee; color: #c2413a; }

/* Lifecycle diagram */
.diagram { margin: 16px 0; padding: 18px; border: 1px solid var(--line); border-radius: var(--radius-lg); background: var(--surface); }
.states { list-style: none; margin: 0 0 12px; padding: 0; display: flex; flex-wrap: wrap; align-items: center; justify-content: center; gap: 8px; }
.state {
  display: grid;
  justify-items: center;
  padding: 8px 16px;
  border: 1.5px solid var(--ink);
  border-radius: 999px;
  font: 700 14px/1.4 var(--mono);
}
.state small { font: 500 11px/1.4 var(--mono); color: var(--ink-3); }
.state--ok { border-color: var(--ok); color: var(--ok); background: var(--ok-soft); }
.arrow { font: 500 12px/1.4 var(--mono); color: var(--ink-3); }
.arrow::after { content: " →"; color: var(--ink); }
.diagram figcaption { color: var(--ink-2); font-size: 14.5px; line-height: 1.85; }

/* WordPress */
.plugin {
  display: grid;
  grid-template-columns: minmax(0, 1fr) minmax(0, 1fr);
  gap: 20px;
  padding: 20px;
  border-radius: var(--radius-lg);
  background: var(--surface);
  border: 1px solid var(--line);
}
.features { margin: 0; padding: 0; list-style: none; display: grid; gap: 8px; font-size: 14.5px; color: var(--ink-2); }
.features li { position: relative; padding-inline-start: 22px; line-height: 1.75; }
.features li::before { content: ""; position: absolute; inset-inline-start: 2px; top: 0.7em; width: 10px; height: 6px; border-inline-start: 2px solid var(--ok); border-bottom: 2px solid var(--ok); transform: rotate(-45deg); }
.btn {
  display: inline-flex;
  align-items: center;
  min-height: 48px;
  padding: 0 24px;
  border-radius: 999px;
  background: var(--primary);
  color: var(--on-primary);
  font-weight: 700;
  text-decoration: none;
}
.btn:hover { background: #2a2a30; }

.changes { margin: 0; }
.changes dt { font-weight: 700; }
.changes dd { margin: 4px 0 0; color: var(--ink-2); }
.tag { display: inline-block; padding: 0 8px; margin-inline-end: 6px; border-radius: 6px; background: var(--ink); color: var(--on-primary); font: 700 12px/22px var(--mono); }

.foot { padding: 24px var(--gutter) 40px; text-align: center; color: var(--ink-3); font-size: 14px; border-top: 1px solid var(--line); }
.foot p { margin: 0; }

@media (max-width: 900px) {
  .layout { grid-template-columns: minmax(0, 1fr); gap: 0; }
  .toc { padding-block: 16px 0; }
  .toc__box { position: static; padding: 12px 14px; border: 1px solid var(--line); border-radius: var(--radius); background: var(--surface); }
  .toc summary { margin: 0; color: var(--ink); }
  .toc ol { grid-template-columns: repeat(auto-fill, minmax(150px, 1fr)); margin-top: 8px; }
  .doc { padding-top: 8px; }
  .plugin { grid-template-columns: minmax(0, 1fr); }
}

@media (max-width: 560px) {
  .topbar__links a:not(.topbar__cta) { display: none; }
  .steps > li { padding-inline-start: 0; }
  .steps > li::before { position: static; display: inline-grid; margin-top: 16px; }
  pre { font-size: 12.5px; padding: 14px; }
}

@media (prefers-reduced-motion: reduce) {
  *, *::before, *::after { transition: none !important; animation: none !important; }
}