/* ============================================================================
   Loom docs — shared stylesheet. Inherits the loom-website design system
   (cream + magenta, Instrument Serif / DM Sans / DM Mono) so /docs is cohesive
   with the landing page. Every docs page links this file; pages carry zero
   per-page CSS, which keeps the whole section visually consistent by construction.
   ============================================================================ */

:root {
  --bg: #faf8f3;
  --bg-2: #ffffff;
  --bg-card: #ffffff;
  --bg-tint: #f3eee5;
  --ink: #1a1816;
  --ink-2: #4a463f;
  --ink-3: #7a7468;
  --ink-4: #b5ad9f;
  --rule: #e6e0d4;
  --rule-soft: #efebe1;
  --rule-strong: #d4cdbe;
  --rule-2: #d4cdbe;
  --accent: #e01396;
  --accent-deep: #a30c6e;
  --accent-bright: #ff3eb0;
  --accent-soft: rgba(224, 19, 150, 0.10);
  --accent-tint: rgba(224, 19, 150, 0.04);
  --accent-glow: rgba(224, 19, 150, 0.5);
  --code-bg: #f7f3ec;
  --code-ink: #2b2722;
  --shadow-sm: 0 1px 2px rgba(26, 24, 22, 0.05), 0 4px 14px rgba(26, 24, 22, 0.05);
  --shadow: 0 4px 12px rgba(26, 24, 22, 0.06), 0 20px 40px rgba(26, 24, 22, 0.08);
  --serif: 'Instrument Serif', 'Source Serif 4', Georgia, serif;
  --sans: 'DM Sans', system-ui, sans-serif;
  --mono: 'DM Mono', ui-monospace, monospace;
  --maxw: 1200px;
  --padx: 2rem;
  --sidebar-w: 250px;
  --toc-w: 200px;
}

*, *::before, *::after { margin: 0; padding: 0; box-sizing: border-box; }
html { scroll-behavior: smooth; background: var(--bg); }
body {
  background: var(--bg);
  color: var(--ink);
  font-family: var(--sans);
  font-size: 16px;
  line-height: 1.55;
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}
a { color: inherit; text-decoration: none; }
::selection { background: var(--accent); color: #fff; }

/* ===== ANNOUNCE BAR (matches landing) ===== */
.announce {
  background: var(--bg-tint);
  color: var(--ink-2);
  border-bottom: 1px solid var(--rule);
  font-size: 0.86rem;
  letter-spacing: -0.005em;
  text-align: center;
  padding: 0.65rem var(--padx);
  position: relative;
  z-index: 60;
}
.announce b { color: var(--ink); font-weight: 600; margin-right: 0.5em; }
.announce a {
  color: var(--accent);
  margin-left: 0.7em;
  display: inline-flex;
  align-items: center;
  gap: 0.35em;
  border-bottom: 1px dotted rgba(224, 19, 150, 0.5);
  padding-bottom: 1px;
}
.announce a:hover { color: var(--accent-deep); border-color: var(--accent-deep); }
@media (max-width: 640px) { .announce { font-size: 0.78rem; padding: 0.55rem 1rem; } }

/* ===== NAV (pill, matches landing) ===== */
nav.site { position: sticky; top: 0.9rem; z-index: 50; margin: 0.9rem var(--padx) 0; pointer-events: none; }
.nav-inner {
  pointer-events: auto;
  max-width: 1080px;
  margin: 0 auto;
  padding: 0.55rem 0.55rem 0.55rem 1.4rem;
  display: flex; align-items: center; justify-content: space-between; gap: 1.5rem;
  background: rgba(255, 255, 255, 0.82);
  backdrop-filter: blur(18px) saturate(1.4);
  -webkit-backdrop-filter: blur(18px) saturate(1.4);
  border: 1px solid var(--rule);
  border-radius: 9999px;
  box-shadow: 0 1px 2px rgba(26, 24, 22, 0.05), 0 12px 32px rgba(26, 24, 22, 0.08);
}
@media (max-width: 640px) { nav.site { margin: 0.6rem 0.6rem 0; } .nav-inner { padding: 0.45rem 0.5rem 0.45rem 1rem; } }
.logo { display: inline-flex; align-items: center; gap: 0.55em; font-weight: 700; font-size: 1.1rem; letter-spacing: -0.015em; }
.logo .mark {
  width: 22px; height: 22px; flex-shrink: 0;
  background: url("data:image/svg+xml;utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 32 32' fill='none'%3E%3Crect width='32' height='32' rx='6.5' fill='%23e01396'/%3E%3Cg stroke='%23faf8f3' stroke-width='1.7' stroke-linecap='round'%3E%3Cline x1='11' y1='6.5' x2='11' y2='25.5'/%3E%3Cline x1='16' y1='6.5' x2='16' y2='25.5'/%3E%3Cline x1='21' y1='6.5' x2='21' y2='25.5'/%3E%3C/g%3E%3Cg stroke='%23faf8f3' stroke-width='1.7' stroke-linecap='round' opacity='0.55'%3E%3Cline x1='6.5' y1='11' x2='25.5' y2='11'/%3E%3Cline x1='6.5' y1='16' x2='25.5' y2='16'/%3E%3Cline x1='6.5' y1='21' x2='25.5' y2='21'/%3E%3C/g%3E%3C/svg%3E") center/contain no-repeat;
}
.logo .by { font-family: var(--mono); font-size: 0.7rem; color: var(--ink-3); font-weight: 400; letter-spacing: 0.1em; margin-left: 0.5em; text-transform: uppercase; }
.logo .by b { color: var(--ink-2); font-weight: 500; }
.nav-links { display: flex; gap: 2rem; font-family: var(--mono); font-size: 0.78rem; letter-spacing: 0.12em; text-transform: uppercase; color: var(--ink-2); }
.nav-links a { transition: color 0.2s; }
.nav-links a:hover, .nav-links a.active { color: var(--accent); }
@media (max-width: 760px) { .nav-links { display: none; } }
.btn {
  display: inline-flex; align-items: center; gap: 0.5em; padding: 0.7em 1.3em;
  background: var(--accent); color: #fff; border-radius: 9999px;
  font-weight: 500; font-size: 0.88rem; letter-spacing: -0.005em;
  transition: background 0.18s, transform 0.18s; cursor: pointer; border: none;
}
.btn:hover { background: var(--accent-deep); transform: translateY(-1px); }
.btn .arrow { font-family: var(--mono); font-size: 0.9em; transition: transform 0.2s; }
.btn:hover .arrow { transform: translateX(2px); }
.btn.ghost { background: transparent; color: var(--ink); border: 1px solid var(--rule-2); }
.btn.ghost:hover { background: var(--bg-tint); color: var(--accent); border-color: var(--accent); }

/* ===== DOCS SHELL — sidebar | article | on-this-page ===== */
.docs-shell {
  max-width: 1320px;
  margin: 1.6rem auto 0;
  padding: 0 var(--padx);
  display: grid;
  grid-template-columns: var(--sidebar-w) minmax(0, 1fr) var(--toc-w);
  gap: 3rem;
  align-items: start;
}
@media (max-width: 1100px) { .docs-shell { grid-template-columns: var(--sidebar-w) minmax(0, 1fr); } .docs-toc { display: none; } }
@media (max-width: 820px) { .docs-shell { grid-template-columns: minmax(0, 1fr); gap: 1.5rem; } .docs-sidebar { display: none; } }

/* ===== SIDEBAR ===== */
.docs-sidebar {
  position: sticky; top: 5.5rem;
  align-self: start;
  max-height: calc(100vh - 7rem);
  overflow-y: auto;
  padding-right: 0.5rem;
  font-size: 0.92rem;
}
.docs-sidebar .group { margin-bottom: 1.6rem; }
.docs-sidebar .group-label {
  font-family: var(--mono); font-size: 0.68rem; letter-spacing: 0.16em; text-transform: uppercase;
  color: var(--ink-3); margin-bottom: 0.6rem; padding-left: 0.85rem;
}
.docs-sidebar ul { list-style: none; }
.docs-sidebar li a {
  display: block; padding: 0.34rem 0.85rem; border-radius: 7px;
  color: var(--ink-2); border-left: 2px solid transparent; transition: color 0.15s, background 0.15s;
}
.docs-sidebar li a:hover { color: var(--ink); background: var(--bg-tint); }
.docs-sidebar li a.active { color: var(--accent); background: var(--accent-tint); border-left-color: var(--accent); font-weight: 600; }

/* ===== ARTICLE ===== */
.docs-article { min-width: 0; padding-bottom: 5rem; max-width: 760px; }
.breadcrumb { font-family: var(--mono); font-size: 0.72rem; letter-spacing: 0.1em; text-transform: uppercase; color: var(--ink-3); margin-bottom: 1.1rem; }
.breadcrumb a:hover { color: var(--accent); }
.breadcrumb .sep { margin: 0 0.5em; color: var(--ink-4); }

.docs-article h1 { font-family: var(--serif); font-weight: 400; font-size: 3rem; line-height: 1.05; letter-spacing: -0.01em; margin-bottom: 0.7rem; }
.docs-article .lede { font-size: 1.18rem; line-height: 1.55; color: var(--ink-2); margin-bottom: 2.4rem; }
.docs-article h2 { font-family: var(--serif); font-weight: 400; font-size: 1.9rem; letter-spacing: -0.01em; margin: 2.8rem 0 1rem; padding-top: 1.6rem; border-top: 1px solid var(--rule-soft); scroll-margin-top: 6rem; }
.docs-article h3 { font-size: 1.12rem; font-weight: 600; letter-spacing: -0.01em; margin: 1.8rem 0 0.7rem; scroll-margin-top: 6rem; }
.docs-article p { color: var(--ink-2); line-height: 1.72; margin: 0 0 1.1rem; }
.docs-article ul, .docs-article ol { color: var(--ink-2); line-height: 1.72; margin: 0 0 1.2rem 1.3rem; }
.docs-article li { margin-bottom: 0.45rem; }
.docs-article li::marker { color: var(--accent); }
.docs-article strong { color: var(--ink); font-weight: 600; }
.docs-article a:not(.btn) { color: var(--accent-deep); border-bottom: 1px solid var(--accent-soft); transition: border-color 0.15s; }
.docs-article a:not(.btn):hover { border-bottom-color: var(--accent); }

/* inline + block code */
.docs-article code { font-family: var(--mono); font-size: 0.86em; background: var(--accent-tint); color: var(--accent-deep); padding: 0.12em 0.4em; border-radius: 5px; border: 1px solid var(--rule-soft); }
.docs-article pre { background: var(--code-bg); border: 1px solid var(--rule); border-radius: 12px; padding: 1.1rem 1.25rem; overflow-x: auto; margin: 0 0 1.4rem; box-shadow: var(--shadow-sm); }
.docs-article pre code { font-size: 0.82rem; line-height: 1.65; background: none; color: var(--code-ink); padding: 0; border: none; }
.docs-article pre .c { color: var(--ink-3); }      /* comment   */
.docs-article pre .k { color: var(--accent-deep); } /* keyword/verb */
.docs-article pre .s { color: #6a7a3a; }            /* string    */

/* callouts */
.callout { display: flex; gap: 0.8rem; background: var(--accent-tint); border: 1px solid var(--accent-soft); border-left: 3px solid var(--accent); border-radius: 10px; padding: 0.9rem 1.1rem; margin: 0 0 1.4rem; }
.callout .ico { font-family: var(--mono); color: var(--accent); font-weight: 500; flex-shrink: 0; }
.callout p { margin: 0; color: var(--ink-2); font-size: 0.95rem; }
.callout.warn { background: #fbf6ec; border-color: #ecd9b0; border-left-color: #c79a3a; }
.callout.warn .ico { color: #b5832a; }

/* verb / definition table */
.docs-article table { width: 100%; border-collapse: collapse; margin: 0 0 1.5rem; font-size: 0.92rem; }
.docs-article th, .docs-article td { text-align: left; padding: 0.6rem 0.8rem; border-bottom: 1px solid var(--rule-soft); vertical-align: top; }
.docs-article th { font-family: var(--mono); font-size: 0.72rem; letter-spacing: 0.08em; text-transform: uppercase; color: var(--ink-3); border-bottom: 1px solid var(--rule); }
.docs-article td code { white-space: nowrap; }

/* pill tags (tiers) */
.tag { font-family: var(--mono); font-size: 0.68rem; letter-spacing: 0.05em; text-transform: uppercase; padding: 0.12em 0.55em; border-radius: 9999px; border: 1px solid var(--rule-strong); color: var(--ink-2); white-space: nowrap; }
.tag.ro { color: #3a6a4a; border-color: #bcdcc6; background: #f0f7f1; }
.tag.ww { color: var(--ink-2); }
.tag.gate { color: var(--accent-deep); border-color: var(--accent-soft); background: var(--accent-tint); }

/* prev / next */
.docs-pager { display: flex; justify-content: space-between; gap: 1rem; margin-top: 3rem; padding-top: 1.6rem; border-top: 1px solid var(--rule); }
.docs-pager a { flex: 1; border: 1px solid var(--rule); border-radius: 12px; padding: 0.9rem 1.1rem; transition: border-color 0.15s, background 0.15s; }
.docs-pager a:hover { border-color: var(--accent); background: var(--accent-tint); }
.docs-pager .dir { font-family: var(--mono); font-size: 0.68rem; letter-spacing: 0.12em; text-transform: uppercase; color: var(--ink-3); }
.docs-pager .ttl { color: var(--ink); font-weight: 600; margin-top: 0.2rem; }
.docs-pager a.next { text-align: right; }

/* ===== ON THIS PAGE ===== */
.docs-toc { position: sticky; top: 5.5rem; align-self: start; font-size: 0.85rem; }
.docs-toc .toc-label { font-family: var(--mono); font-size: 0.66rem; letter-spacing: 0.16em; text-transform: uppercase; color: var(--ink-3); margin-bottom: 0.7rem; }
.docs-toc ul { list-style: none; border-left: 1px solid var(--rule); }
.docs-toc li a { display: block; padding: 0.28rem 0 0.28rem 0.9rem; margin-left: -1px; border-left: 1px solid transparent; color: var(--ink-3); transition: color 0.15s; }
.docs-toc li.sub a { padding-left: 1.7rem; }
.docs-toc li a:hover, .docs-toc li a.active { color: var(--accent); border-left-color: var(--accent); }

/* ===== DOCS INDEX (landing) ===== */
.docs-hero { max-width: 1320px; margin: 2.4rem auto 0; padding: 0 var(--padx); }
.docs-hero h1 { font-family: var(--serif); font-weight: 400; font-size: 3.4rem; line-height: 1.02; letter-spacing: -0.015em; }
.docs-hero .lede { font-size: 1.22rem; color: var(--ink-2); max-width: 640px; margin-top: 0.8rem; }
.docs-cards { max-width: 1320px; margin: 2.2rem auto 4rem; padding: 0 var(--padx); display: grid; grid-template-columns: repeat(auto-fill, minmax(280px, 1fr)); gap: 1.1rem; }
.docs-card { display: block; background: var(--bg-card); border: 1px solid var(--rule); border-radius: 14px; padding: 1.3rem 1.4rem; transition: border-color 0.18s, transform 0.18s, box-shadow 0.18s; }
.docs-card:hover { border-color: var(--accent); transform: translateY(-2px); box-shadow: var(--shadow); }
.docs-card .eyebrow { font-family: var(--mono); font-size: 0.68rem; letter-spacing: 0.14em; text-transform: uppercase; color: var(--accent); margin-bottom: 0.5rem; }
.docs-card h3 { font-family: var(--serif); font-weight: 400; font-size: 1.45rem; letter-spacing: -0.01em; margin-bottom: 0.4rem; }
.docs-card p { color: var(--ink-2); font-size: 0.93rem; line-height: 1.55; }

/* ===== FOOTER (matches landing) ===== */
footer.site { border-top: 1px solid var(--rule); margin-top: 2rem; background: var(--bg-tint); }
.footer-inner { max-width: var(--maxw); margin: 0 auto; padding: 2rem var(--padx); display: flex; align-items: center; justify-content: space-between; gap: 1.5rem; flex-wrap: wrap; font-family: var(--mono); font-size: 0.78rem; letter-spacing: 0.04em; color: var(--ink-3); }
.footer-inner a:hover { color: var(--accent); }