/* ══════════════════════════════════════════════════════════════════
   VIUCraft Documentation — full stylesheet
   Self-contained: defines the --docs-* shell variables, the compact
   category tab bar, mobile off-canvas nav, page/TOC layout, the hub
   sections, article typography + code blocks, and the browse/search/
   tag/audience pages. Blue → cyan accent system matched to the rest of
   the site. Dark mode via [data-theme="dark"].
   ══════════════════════════════════════════════════════════════════ */

/* ───────────────────────── SHELL VARIABLES ───────────────────────── */
:root {
  --docs-accent: #0ea5e9;
  --docs-accent-strong: #2563eb;
  --docs-accent-cyan: #06b6d4;
  --docs-grad: linear-gradient(135deg, #2563eb 0%, #0ea5e9 55%, #06b6d4 100%);
  --docs-grad-text: linear-gradient(104deg, #2563eb 0%, #0ea5e9 50%, #06b6d4 100%);
  --docs-accent-soft: rgba(14, 165, 233, 0.1);
  --docs-accent-ring: rgba(14, 165, 233, 0.18);

  --docs-bg-primary: #ffffff;
  --docs-bg-secondary: hsl(210 40% 98%);
  --docs-bg-tertiary: hsl(210 40% 96.1%);
  --docs-border-color: rgba(15, 23, 42, 0.08);
  --docs-border-strong: rgba(15, 23, 42, 0.14);
  --docs-text-primary: #0f172a;
  --docs-text-secondary: #475569;
  --docs-text-muted: #94a3b8;
  --docs-input-bg: #ffffff;
  --docs-input-border: rgba(15, 23, 42, 0.12);
  --docs-code-bg: #0e0e1a;
  --docs-code-bar: #14141f;

  --docs-header-h: 52px;

  --docs-mono: "JetBrains Mono", "SF Mono", "Fira Code", ui-monospace, "Courier New", monospace;

  --radius-sm: 6px;
  --radius-md: 10px;
  --radius-lg: 16px;
  --radius-full: 9999px;
  --shadow-sm: 0 1px 2px rgba(15, 23, 42, 0.05);
  --shadow-md: 0 4px 6px rgba(15, 23, 42, 0.07), 0 1px 3px rgba(15, 23, 42, 0.06);
  --shadow-lg: 0 10px 24px -8px rgba(15, 23, 42, 0.14), 0 4px 6px rgba(15, 23, 42, 0.05);
  --transition-fast: 150ms cubic-bezier(0.4, 0, 0.2, 1);
  --transition-base: 250ms cubic-bezier(0.16, 1, 0.3, 1);

  --font-size-xs: 0.75rem;
  --font-size-sm: 0.875rem;
  --font-size-base: 1rem;
  --font-size-lg: 1.125rem;
  --font-size-xl: 1.25rem;
}

[data-theme="dark"] {
  --docs-bg-primary: #0e0e1a;
  --docs-bg-secondary: #07070e;
  --docs-bg-tertiary: #14141f;
  --docs-border-color: rgba(255, 255, 255, 0.08);
  --docs-border-strong: rgba(255, 255, 255, 0.14);
  --docs-text-primary: #f1f5f9;
  --docs-text-secondary: #94a3b8;
  --docs-text-muted: #64748b;
  --docs-input-bg: rgba(255, 255, 255, 0.03);
  --docs-input-border: rgba(255, 255, 255, 0.14);
}

/* ───────────────────────── SKIP LINK ───────────────────────── */
.docs-skip-link {
  position: absolute;
  left: -999px;
  top: 0;
  z-index: 200;
  padding: 0.6rem 1rem;
  background: var(--docs-accent-strong);
  color: #fff;
  border-radius: 0 0 var(--radius-md) 0;
  font-size: var(--font-size-sm);
  font-weight: 600;
  text-decoration: none;
}
.docs-skip-link:focus { left: 0; }

/* ───────────────────────── READING PROGRESS ───────────────────────── */
.docs-reading-progress {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  height: 3px;
  background: transparent;
  z-index: 120;
  pointer-events: none;
}
.docs-reading-progress-bar {
  height: 100%;
  width: 0;
  background: var(--docs-grad);
  transition: width 80ms linear;
}

/* ───────────────────────── COMPACT CATEGORY TAB BAR ───────────────────────── */
/* The main public navbar handles brand / search / theme toggle. This is a
   slim sticky strip directly below it, holding the category navigation. */
.docs-header {
  position: sticky;
  top: 0;
  z-index: 80;
  margin-top: 100px;
  background: color-mix(in srgb, var(--docs-bg-primary) 88%, transparent);
  backdrop-filter: saturate(180%) blur(12px);
  -webkit-backdrop-filter: saturate(180%) blur(12px);
  border-bottom: 1px solid var(--docs-border-color);
  transition: box-shadow var(--transition-base);
}
.docs-header.has-shadow { box-shadow: var(--shadow-md); }

.docs-header-inner {
  display: none;             /* mobile only — see media query */
  align-items: center;
  gap: 0.75rem;
  max-width: 1240px;
  margin: 0 auto;
  padding: 0.5rem 1.25rem;
}
.docs-back-link {
  display: inline-grid;
  place-items: center;
  width: 34px;
  height: 34px;
  border-radius: var(--radius-sm);
  color: var(--docs-text-secondary);
  border: 1px solid var(--docs-border-color);
  text-decoration: none;
  transition: background var(--transition-fast), color var(--transition-fast);
}
.docs-back-link:hover { background: var(--docs-accent-soft); color: var(--docs-accent-strong); }
.docs-mobile-menu-btn {
  display: inline-grid;
  place-items: center;
  width: 34px;
  height: 34px;
  border-radius: var(--radius-sm);
  border: 1px solid var(--docs-border-color);
  background: transparent;
  color: var(--docs-text-secondary);
  cursor: pointer;
}
.docs-header-title {
  margin: 0;
  font-size: var(--font-size-sm);
  font-weight: 600;
  color: var(--docs-text-secondary);
}

/* the horizontal tab strip */
.docs-header-nav {
  display: flex;
  align-items: center;
  gap: 0.15rem;
  max-width: 1240px;
  margin: 0 auto;
  padding: 0 1.25rem;
  overflow-x: auto;
  scrollbar-width: none;
}
.docs-header-nav::-webkit-scrollbar { display: none; }
.docs-header-nav::after {
  content: "";
  position: sticky;
  right: 0;
  flex-shrink: 0;
  width: 40px;
  margin-left: -40px;
  background: linear-gradient(to right, transparent, var(--docs-bg-primary));
  pointer-events: none;
}
.docs-header-nav a {
  position: relative;
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  flex-shrink: 0;
  padding: 0.85rem 0.85rem;
  font-size: var(--font-size-sm);
  font-weight: 500;
  white-space: nowrap;
  color: var(--docs-text-secondary);
  text-decoration: none;
  border-bottom: 2px solid transparent;
  transition: color var(--transition-fast), border-color var(--transition-fast);
}
.docs-header-nav a i { font-size: 0.85em; opacity: 0.75; }
.docs-header-nav a:hover { color: var(--docs-text-primary); }
.docs-header-nav a.active {
  color: var(--docs-accent-strong);
  border-bottom-color: var(--docs-accent);
}
.docs-header-nav a.active i { opacity: 1; }
[data-theme="dark"] .docs-header-nav a.active { color: #7dd3fc; }

/* ───────────────────────── MOBILE OFF-CANVAS NAV ───────────────────────── */
.docs-mobile-overlay {
  position: fixed;
  inset: 0;
  background: rgba(7, 7, 14, 0.5);
  backdrop-filter: blur(2px);
  z-index: 130;
  opacity: 0;
  visibility: hidden;
  transition: opacity var(--transition-base), visibility var(--transition-base);
}
.docs-mobile-overlay.open { opacity: 1; visibility: visible; }
.docs-mobile-sidebar {
  position: fixed;
  top: 0;
  left: 0;
  bottom: 0;
  width: min(82vw, 320px);
  z-index: 140;
  background: var(--docs-bg-primary);
  border-right: 1px solid var(--docs-border-color);
  box-shadow: var(--shadow-lg);
  transform: translateX(-100%);
  transition: transform var(--transition-base);
  display: flex;
  flex-direction: column;
  overflow-y: auto;
}
.docs-mobile-sidebar.open { transform: translateX(0); }
.docs-mobile-sidebar-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 1rem 1.25rem;
  border-bottom: 1px solid var(--docs-border-color);
}
.docs-mobile-sidebar-header h5 { margin: 0; font-size: var(--font-size-base); font-weight: 700; color: var(--docs-text-primary); }
.docs-mobile-sidebar-close {
  width: 34px; height: 34px;
  display: grid; place-items: center;
  border: none; background: transparent;
  color: var(--docs-text-secondary); cursor: pointer;
  border-radius: var(--radius-sm);
}
.docs-mobile-sidebar-close:hover { background: var(--docs-bg-tertiary); }
.docs-mobile-sidebar-search { padding: 1rem 1.25rem; }
.docs-mobile-sidebar-search .form-control {
  width: 100%;
  height: 42px;
  border-radius: var(--radius-md);
  border: 1px solid var(--docs-input-border);
  background: var(--docs-input-bg);
  color: var(--docs-text-primary);
  padding: 0 0.9rem;
  font-size: var(--font-size-sm);
}
.docs-mobile-sidebar-search .form-control:focus { outline: none; border-color: var(--docs-accent); box-shadow: 0 0 0 4px var(--docs-accent-ring); }
.docs-mobile-sidebar-nav { list-style: none; margin: 0; padding: 0 0.75rem 1.5rem; }
.docs-mobile-sidebar-nav a {
  display: flex;
  align-items: center;
  gap: 0.7rem;
  padding: 0.7rem 0.85rem;
  border-radius: var(--radius-md);
  font-size: var(--font-size-sm);
  font-weight: 500;
  color: var(--docs-text-secondary);
  text-decoration: none;
  transition: background var(--transition-fast), color var(--transition-fast);
}
.docs-mobile-sidebar-nav a i { width: 18px; text-align: center; opacity: 0.7; }
.docs-mobile-sidebar-nav a:hover { background: var(--docs-accent-soft); color: var(--docs-accent-strong); }

/* ───────────────────────── PAGE + CONTAINER ───────────────────────── */
.docs-page { min-height: 100vh; background: var(--docs-bg-secondary); }
.docs-container {
  display: flex;
  gap: clamp(2rem, 4vw, 3.5rem);
  max-width: 1240px;
  margin: 0 auto;
  padding: clamp(2rem, 4vw, 3rem) 1.5rem clamp(3rem, 6vw, 5rem);
  align-items: flex-start;
}
.docs-content { flex: 1; min-width: 0; }
.docs-content-narrow { max-width: 820px; }

/* ───────────────────────── TOC SIDEBAR ───────────────────────── */
.docs-toc {
  width: 260px;
  flex-shrink: 0;
  position: sticky;
  top: calc(100px + var(--docs-header-h) + 1.5rem);
  align-self: flex-start;
  max-height: calc(100vh - 100px - var(--docs-header-h) - 3rem);
  overflow-y: auto;
}
.docs-toc > h6 {
  font-size: var(--font-size-xs);
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--docs-text-muted);
  margin: 0 0 0.85rem;
  padding-left: 0.85rem;
}
.docs-toc-content ul { list-style: none; margin: 0; padding: 0; border-left: 1px solid var(--docs-border-color); }
.docs-toc-content li { margin: 0; }
.docs-toc-content li.toc-h3 a { padding-left: 1.6rem; font-size: var(--font-size-xs); }
.docs-toc-content a {
  display: block;
  padding: 0.4rem 0.85rem;
  margin-left: -1px;
  border-left: 2px solid transparent;
  font-size: var(--font-size-sm);
  line-height: 1.4;
  color: var(--docs-text-secondary);
  text-decoration: none;
  transition: color var(--transition-fast), border-color var(--transition-fast);
}
.docs-toc-content a:hover { color: var(--docs-accent-strong); }
.docs-toc-content a.active {
  color: var(--docs-accent-strong);
  border-left-color: var(--docs-accent);
  font-weight: 600;
}
[data-theme="dark"] .docs-toc-content a.active { color: #7dd3fc; }

/* ───────────────────────── SCROLL TO TOP ───────────────────────── */
.docs-scroll-top {
  position: fixed;
  bottom: 1.5rem;
  right: 1.5rem;
  width: 42px;
  height: 42px;
  z-index: 90;
  display: grid;
  place-items: center;
  border: none;
  border-radius: var(--radius-full);
  background: var(--docs-grad);
  color: #fff;
  cursor: pointer;
  opacity: 0;
  visibility: hidden;
  transform: translateY(8px);
  box-shadow: 0 10px 24px -8px rgba(37, 99, 235, 0.6);
  transition: opacity var(--transition-base), transform var(--transition-base), visibility var(--transition-base);
}
.docs-scroll-top.visible { opacity: 1; visibility: visible; transform: translateY(0); }
.docs-scroll-top:hover { transform: translateY(-2px); }

/* ───────────────────────── HERO ───────────────────────── */
.docs-hero {
  position: relative;
  overflow: hidden;
  padding: clamp(3rem, 7vw, 5rem) 1.5rem clamp(2.5rem, 5vw, 3.5rem);
  background:
    radial-gradient(120% 140% at 50% -20%, rgba(14, 165, 233, 0.08), transparent 60%),
    var(--docs-bg-primary);
  border-bottom: 1px solid var(--docs-border-color);
  text-align: center;
}
.docs-hero::before {
  content: "";
  position: absolute;
  inset: 0;
  background-image: radial-gradient(circle, rgba(15, 23, 42, 0.045) 1px, transparent 1px);
  background-size: 26px 26px;
  -webkit-mask-image: radial-gradient(ellipse 70% 80% at 50% 0%, #000 30%, transparent 72%);
  mask-image: radial-gradient(ellipse 70% 80% at 50% 0%, #000 30%, transparent 72%);
  pointer-events: none;
}
[data-theme="dark"] .docs-hero {
  background:
    radial-gradient(120% 140% at 50% -20%, rgba(37, 99, 235, 0.22), transparent 60%),
    var(--docs-bg-primary);
}
[data-theme="dark"] .docs-hero::before {
  background-image: radial-gradient(circle, rgba(255, 255, 255, 0.04) 1px, transparent 1px);
}

.docs-hero-inner { position: relative; z-index: 1; max-width: 680px; margin: 0 auto; }
.docs-hero-inner h1 {
  font-size: clamp(2rem, 4.5vw, 2.9rem);
  font-weight: 700;
  letter-spacing: -0.03em;
  line-height: 1.08;
  margin: 0 0 0.85rem;
  color: var(--docs-text-primary);
  text-wrap: balance;
}
.docs-hero-inner > p {
  font-size: clamp(1.02rem, 2vw, 1.15rem);
  line-height: 1.6;
  color: var(--docs-text-secondary);
  max-width: 540px;
  margin: 0 auto 2rem;
  text-wrap: balance;
}
.docs-hero-search { max-width: 580px; margin: 0 auto; }
.docs-hero-search .input-group {
  display: flex;
  border-radius: var(--radius-lg);
  background: var(--docs-input-bg);
  border: 1px solid var(--docs-input-border);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
  transition: border-color var(--transition-base), box-shadow var(--transition-base);
}
.docs-hero-search .input-group:focus-within { border-color: var(--docs-accent); box-shadow: 0 0 0 4px var(--docs-accent-ring), var(--shadow-lg); }
.docs-hero-search .form-control {
  flex: 1;
  border: none;
  background: transparent;
  padding: 1rem 1.25rem;
  font-size: 1.02rem;
  color: var(--docs-text-primary);
}
.docs-hero-search .form-control::placeholder { color: var(--docs-text-muted); }
.docs-hero-search .form-control:focus { outline: none; box-shadow: none; }
.docs-hero-search .btn-primary {
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  margin: 6px;
  padding: 0.6rem 1.4rem;
  border: none;
  border-radius: var(--radius-md);
  font-weight: 600;
  color: #fff;
  background: var(--docs-grad);
  box-shadow: 0 6px 16px -6px rgba(37, 99, 235, 0.55);
  cursor: pointer;
  transition: transform var(--transition-base), box-shadow var(--transition-base);
}
.docs-hero-search .btn-primary:hover { transform: translateY(-1px); box-shadow: 0 10px 22px -6px rgba(37, 99, 235, 0.7); }

/* ───────────────────────── HOME LAYOUT ───────────────────────── */
.docs-home { display: flex; flex-direction: column; gap: clamp(2.5rem, 5vw, 3.75rem); }
.section-title {
  font-size: 1.05rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  color: var(--docs-text-primary);
  margin: 0 0 1.25rem;
  display: flex;
  align-items: center;
  gap: 0.6rem;
}
.section-title::after { content: ""; flex: 1; height: 1px; background: var(--docs-border-color); }

/* AUDIENCE CARDS */
.audience-cards { display: grid; grid-template-columns: repeat(auto-fit, minmax(260px, 1fr)); gap: 1.25rem; }
.audience-card {
  position: relative;
  display: block;
  padding: 1.75rem;
  border-radius: var(--radius-lg);
  background: var(--docs-bg-primary);
  border: 1px solid var(--docs-border-color);
  box-shadow: var(--shadow-sm);
  text-decoration: none;
  overflow: hidden;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
}
.audience-card::before {
  content: "";
  position: absolute;
  inset: 0 auto 0 0;
  width: 3px;
  background: var(--audience-accent, var(--docs-accent));
  transform: scaleY(0);
  transform-origin: top;
  transition: transform var(--transition-base);
}
.audience-card:hover { transform: translateY(-4px); box-shadow: var(--shadow-lg); border-color: color-mix(in srgb, var(--audience-accent, var(--docs-accent)) 35%, transparent); }
.audience-card:hover::before { transform: scaleY(1); }
.audience-icon {
  display: grid;
  place-items: center;
  width: 48px;
  height: 48px;
  border-radius: var(--radius-md);
  font-size: 1.25rem;
  color: #fff;
  margin-bottom: 1.1rem;
  background: var(--audience-grad, var(--docs-grad));
  box-shadow: 0 8px 18px -8px var(--audience-accent, var(--docs-accent));
}
.audience-card h3 { font-size: 1.15rem; font-weight: 700; letter-spacing: -0.01em; color: var(--docs-text-primary); margin: 0 0 0.4rem; }
.audience-card p { font-size: var(--font-size-sm); line-height: 1.6; color: var(--docs-text-secondary); margin: 0; }
.audience-dev     { --audience-accent: #2563eb; --audience-grad: linear-gradient(135deg, #1d4ed8, #3b82f6); }
.audience-biz     { --audience-accent: #0891b2; --audience-grad: linear-gradient(135deg, #0891b2, #22d3ee); }
.audience-content { --audience-accent: #0ea5e9; --audience-grad: linear-gradient(135deg, #0ea5e9, #38bdf8); }
.audience-admin   { --audience-accent: #2563eb; --audience-grad: linear-gradient(135deg, #2563eb, #0ea5e9); }

/* CATEGORY GRID */
.category-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(240px, 1fr)); gap: 1.1rem; }
.category-card {
  position: relative;
  display: flex;
  flex-direction: column;
  padding: 1.5rem;
  border-radius: var(--radius-lg);
  background: var(--docs-bg-primary);
  border: 1px solid var(--docs-border-color);
  box-shadow: var(--shadow-sm);
  text-decoration: none;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
}
.category-card:hover { transform: translateY(-4px); box-shadow: var(--shadow-lg); border-color: var(--docs-accent-ring); }
.category-icon {
  display: grid;
  place-items: center;
  width: 42px;
  height: 42px;
  border-radius: var(--radius-md);
  font-size: 1.05rem;
  color: var(--docs-accent-strong);
  background: var(--docs-accent-soft);
  margin-bottom: 1rem;
  transition: background var(--transition-base), color var(--transition-base);
}
.category-card:hover .category-icon { background: var(--docs-grad); color: #fff; }
.category-card h3 { font-size: 1.02rem; font-weight: 700; letter-spacing: -0.01em; color: var(--docs-text-primary); margin: 0 0 0.4rem; }
.category-card p { font-size: var(--font-size-sm); line-height: 1.55; color: var(--docs-text-secondary); margin: 0 0 1rem; }
.category-count {
  margin-top: auto;
  align-self: flex-start;
  white-space: nowrap;
  font-size: var(--font-size-xs);
  font-weight: 600;
  color: var(--docs-accent-strong);
  background: var(--docs-accent-soft);
  border-radius: var(--radius-full);
  padding: 0.2rem 0.7rem;
}
[data-theme="dark"] .category-count { color: #7dd3fc; }

/* RECENT ARTICLES */
.recent-list { border: 1px solid var(--docs-border-color); border-radius: var(--radius-lg); overflow: hidden; background: var(--docs-bg-primary); }
.recent-item { display: block; padding: 1.25rem 1.5rem; border-bottom: 1px solid var(--docs-border-color); text-decoration: none; transition: background var(--transition-fast); }
.recent-item:last-child { border-bottom: none; }
.recent-item:hover { background: var(--docs-accent-soft); }
.recent-meta { display: flex; align-items: center; gap: 0.75rem; margin-bottom: 0.45rem; }
.recent-category { font-size: var(--font-size-xs); font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; color: var(--docs-accent-strong); }
[data-theme="dark"] .recent-category { color: #7dd3fc; }
.recent-time { display: inline-flex; align-items: center; gap: 0.3rem; font-size: var(--font-size-xs); color: var(--docs-text-muted); }
.recent-item h4 { font-size: 1.02rem; font-weight: 600; letter-spacing: -0.01em; color: var(--docs-text-primary); margin: 0 0 0.3rem; transition: color var(--transition-fast); }
.recent-item:hover h4 { color: var(--docs-accent-strong); }
.recent-item p { font-size: var(--font-size-sm); line-height: 1.55; color: var(--docs-text-secondary); margin: 0; }

/* INDEX SIDEBAR */
.docs-index-sidebar { display: flex; flex-direction: column; gap: 1.25rem; }
.docs-sidebar-card { border: 1px solid var(--docs-border-color); border-radius: var(--radius-lg); background: var(--docs-bg-primary); box-shadow: var(--shadow-sm); overflow: hidden; }
.docs-sidebar-card-header { padding: 0.9rem 1.1rem; border-bottom: 1px solid var(--docs-border-color); background: var(--docs-bg-tertiary); }
.docs-sidebar-card-header h5 { display: flex; align-items: center; gap: 0.55rem; margin: 0; font-size: var(--font-size-sm); font-weight: 700; color: var(--docs-text-primary); }
.docs-sidebar-card-header h5 i { color: var(--docs-accent); }
.docs-sidebar-card-body { padding: 0.85rem 1rem; }
.docs-audience-link { display: flex; align-items: center; gap: 0.75rem; padding: 0.6rem 0.65rem; border-radius: var(--radius-md); text-decoration: none; transition: background var(--transition-fast); }
.docs-audience-link:hover { background: var(--docs-accent-soft); }
.docs-audience-icon { display: grid; place-items: center; width: 36px; height: 36px; border-radius: var(--radius-sm); font-size: 0.9rem; color: #fff; flex-shrink: 0; box-shadow: 0 6px 14px -6px rgba(15, 23, 42, 0.4); }
.docs-audience-icon-dev     { background: linear-gradient(135deg, #1d4ed8, #3b82f6); }
.docs-audience-icon-content { background: linear-gradient(135deg, #0ea5e9, #38bdf8); }
.docs-audience-icon-biz     { background: linear-gradient(135deg, #0891b2, #22d3ee); }
.docs-audience-link h6 { font-size: var(--font-size-sm); font-weight: 600; color: var(--docs-text-primary); margin: 0 0 0.1rem; }
.docs-audience-link p { font-size: var(--font-size-xs); color: var(--docs-text-muted); margin: 0; line-height: 1.4; }
/* SDK card */
.docs-sdk-desc { font-size: var(--font-size-xs); color: var(--docs-text-muted); line-height: 1.5; margin: 0 0 0.65rem; }
.docs-sdk-install {
  display: flex; align-items: center; gap: 0.5rem;
  padding: 0.5rem 0.7rem; border-radius: var(--radius-md);
  background: var(--docs-code-bg); font-family: var(--docs-mono);
  font-size: 0.78rem; margin-bottom: 0.75rem;
}
.docs-sdk-install code { color: #e2e8f0; background: none; padding: 0; flex: 1; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.docs-sdk-copy {
  display: grid; place-items: center; width: 28px; height: 28px; flex-shrink: 0;
  border: 1px solid rgba(255,255,255,0.1); border-radius: var(--radius-sm);
  background: rgba(255,255,255,0.04); color: #94a3b8; cursor: pointer;
  font-size: 0.75rem; transition: color var(--transition-fast), border-color var(--transition-fast);
}
.docs-sdk-copy:hover { color: #e2e8f0; border-color: rgba(255,255,255,0.2); }
.docs-sdk-links { display: flex; flex-direction: column; gap: 0.4rem; }
.docs-sdk-link {
  display: inline-flex; align-items: center; justify-content: center; gap: 0.4rem;
  padding: 0.45rem 0.75rem; border-radius: var(--radius-md);
  font-size: var(--font-size-xs); font-weight: 600; text-decoration: none; white-space: nowrap;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
}
.docs-sdk-link--npm {
  color: #fff; background: var(--docs-accent-strong);
  border: 1px solid var(--docs-accent-strong);
}
.docs-sdk-link--npm:hover { background: #1d4ed8; border-color: #1d4ed8; color: #fff; }
.docs-sdk-link--gh {
  color: var(--docs-text-secondary); background: transparent;
  border: 1px solid var(--docs-border-strong);
}
.docs-sdk-link--gh:hover { color: var(--docs-text-primary); border-color: var(--docs-text-muted); }

.docs-sidebar-tags { display: flex; flex-wrap: wrap; gap: 0.45rem; }

/* TAG CHIPS (shared) */
.docs-tag {
  display: inline-flex;
  align-items: center;
  font-size: var(--font-size-xs);
  font-weight: 500;
  color: var(--docs-accent);
  background: none;
  border: 1px solid var(--docs-accent-ring);
  border-radius: var(--radius-full);
  padding: 0.3rem 0.75rem;
  text-decoration: none;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
}
.docs-tag::before { content: "#"; opacity: 0.45; margin-right: 1px; }
.docs-tag:hover { color: #fff; background: var(--docs-accent-strong); border-color: var(--docs-accent-strong); }

/* ───────────────────────── BREADCRUMB ───────────────────────── */
.docs-breadcrumb { margin-bottom: 1.5rem; }
.docs-breadcrumb .breadcrumb { display: flex; flex-wrap: wrap; align-items: center; gap: 0.5rem; margin: 0; padding: 0; list-style: none; font-size: var(--font-size-sm); }
.docs-breadcrumb .breadcrumb-item { display: inline-flex; align-items: center; gap: 0.5rem; color: var(--docs-text-muted); }
.docs-breadcrumb .breadcrumb-item + .breadcrumb-item::before { content: "/"; color: var(--docs-text-muted); opacity: 0.6; }
.docs-breadcrumb .breadcrumb-item a { color: var(--docs-text-secondary); text-decoration: none; transition: color var(--transition-fast); }
.docs-breadcrumb .breadcrumb-item a:hover { color: var(--docs-accent-strong); }
.docs-breadcrumb .breadcrumb-item.active { color: var(--docs-text-primary); font-weight: 500; }

/* ───────────────────────── ARTICLE ───────────────────────── */
.docs-article > h1 {
  font-size: clamp(1.9rem, 3.5vw, 2.5rem);
  font-weight: 700;
  letter-spacing: -0.03em;
  line-height: 1.12;
  color: var(--docs-text-primary);
  margin: 0 0 1rem;
  text-wrap: balance;
}
.docs-article-header { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: 0.75rem; padding-bottom: 1.5rem; margin-bottom: 2rem; border-bottom: 1px solid var(--docs-border-color); }
.docs-article-meta { display: flex; flex-wrap: wrap; gap: 1.25rem; font-size: var(--font-size-sm); color: var(--docs-text-muted); }
.docs-article-meta i { color: var(--docs-text-muted); }
.docs-article-tags { display: flex; gap: 0.4rem; flex-wrap: wrap; }

/* inline (mobile) TOC */
.docs-toc-inline {
  display: none;
  margin-bottom: 2rem;
  padding: 1rem 1.25rem;
  border: 1px solid var(--docs-border-color);
  border-radius: var(--radius-md);
  background: var(--docs-bg-tertiary);
}
.docs-toc-inline h6 { font-size: var(--font-size-xs); font-weight: 700; text-transform: uppercase; letter-spacing: 0.08em; color: var(--docs-text-muted); margin: 0 0 0.6rem; }
.docs-toc-inline ul { list-style: none; margin: 0; padding: 0; }
.docs-toc-inline li { margin: 0; }
.docs-toc-inline li.toc-h3 a { padding-left: 1rem; font-size: var(--font-size-xs); }
.docs-toc-inline a { display: block; padding: 0.3rem 0; font-size: var(--font-size-sm); color: var(--docs-text-secondary); text-decoration: none; }
.docs-toc-inline a:hover { color: var(--docs-accent-strong); }

/* article prose */
.docs-article-content { font-size: 1.02rem; line-height: 1.8; color: var(--docs-text-secondary); }
.docs-article-content > *:first-child { margin-top: 0; }
.docs-article-content h2 {
  scroll-margin-top: calc(var(--docs-header-h) + 1.5rem);
  display: flex;
  align-items: center;
  gap: 0.7rem;
  font-size: 1.5rem;
  font-weight: 700;
  letter-spacing: -0.02em;
  color: var(--docs-text-primary);
  margin: 2.75rem 0 1rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid var(--docs-border-color);
}
.docs-article-content h2::before { content: ""; width: 4px; height: 1.1em; border-radius: var(--radius-full); background: var(--docs-grad); flex-shrink: 0; }
.docs-article-content h3 {
  scroll-margin-top: calc(var(--docs-header-h) + 1.5rem);
  font-size: 1.2rem;
  font-weight: 700;
  letter-spacing: -0.01em;
  color: var(--docs-text-primary);
  margin: 2rem 0 0.75rem;
}
.docs-article-content p { margin: 0 0 1.15rem; }
.docs-article-content a { color: var(--docs-accent-strong); font-weight: 500; text-decoration: none; border-bottom: 1px solid transparent; transition: border-color var(--transition-fast); }
.docs-article-content a:hover { border-bottom-color: currentColor; }
[data-theme="dark"] .docs-article-content a { color: #7dd3fc; }
.docs-article-content ul, .docs-article-content ol { margin: 0 0 1.15rem; padding-left: 1.4rem; }
.docs-article-content li { margin-bottom: 0.5rem; }
.docs-article-content li::marker { color: var(--docs-accent); }
.docs-article-content strong { color: var(--docs-text-primary); font-weight: 600; }
.docs-article-content img { max-width: 100%; height: auto; border-radius: var(--radius-md); border: 1px solid var(--docs-border-color); }

/* inline code */
.docs-article-content :not(pre) > code {
  font-family: var(--docs-mono);
  font-size: 0.86em;
  color: var(--docs-accent-strong);
  background: var(--docs-accent-soft);
  border: 1px solid rgba(14, 165, 233, 0.18);
  border-radius: var(--radius-sm);
  padding: 0.1rem 0.4rem;
  word-break: break-word;
}
[data-theme="dark"] .docs-article-content :not(pre) > code { color: #7dd3fc; }

/* code blocks */
.code-block-wrapper {
  position: relative;
  margin: 0 0 1.5rem;
  border-radius: var(--radius-md);
  background: var(--docs-code-bg);
  border: 1px solid rgba(255, 255, 255, 0.08);
  box-shadow: var(--shadow-md);
  overflow: hidden;
}
.code-block-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 1rem;
  height: 38px;
  background:
    radial-gradient(circle 4px at 18px 19px, #ff5f56 50%, transparent 51%),
    radial-gradient(circle 4px at 36px 19px, #ffbd2e 50%, transparent 51%),
    radial-gradient(circle 4px at 54px 19px, #27c93f 50%, transparent 51%),
    var(--docs-code-bar);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
.code-lang-label { font-size: var(--font-size-xs); font-weight: 600; color: var(--docs-text-muted); margin-left: 56px; }
.code-copy-btn {
  display: inline-flex; align-items: center; gap: 0.3rem;
  padding: 0.2rem 0.6rem; border: 1px solid rgba(255,255,255,0.12); border-radius: var(--radius-sm);
  background: transparent; color: var(--docs-text-muted); font-size: var(--font-size-xs); font-weight: 600;
  cursor: pointer; transition: color var(--transition-fast), border-color var(--transition-fast);
}
.code-copy-btn:hover { color: #fff; border-color: rgba(255,255,255,0.25); }
.docs-article-content .code-block-wrapper pre { margin: 0; border: none; border-radius: 0; box-shadow: none; overflow: visible; }
.docs-article-content .code-block-wrapper pre::before { display: none; }
.docs-article-content .code-block-wrapper { margin: 0 0 1.5rem; }
.docs-article-content pre {
  position: relative;
  margin: 0 0 1.5rem;
  border-radius: var(--radius-md);
  background: var(--docs-code-bg);
  border: 1px solid rgba(255, 255, 255, 0.08);
  box-shadow: var(--shadow-md);
  overflow: hidden;
}
.docs-article-content pre::before {
  content: "";
  display: block;
  height: 38px;
  background:
    radial-gradient(circle 4px at 18px 19px, #ff5f56 50%, transparent 51%),
    radial-gradient(circle 4px at 36px 19px, #ffbd2e 50%, transparent 51%),
    radial-gradient(circle 4px at 54px 19px, #27c93f 50%, transparent 51%),
    var(--docs-code-bar);
  border-bottom: 1px solid rgba(255, 255, 255, 0.06);
}
.docs-article-content pre code {
  display: block;
  padding: 1.1rem 1.25rem;
  font-family: var(--docs-mono);
  font-size: 0.85rem;
  line-height: 1.7;
  color: #cdd6f4;
  background: transparent;
  overflow-x: auto;
  white-space: pre;
}
.docs-article-content blockquote {
  margin: 0 0 1.5rem;
  padding: 0.85rem 1.25rem;
  border-left: 3px solid var(--docs-accent);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  background: var(--docs-accent-soft);
  color: var(--docs-text-secondary);
}
.docs-article-content blockquote p:last-child { margin-bottom: 0; }
.docs-article-content table { width: 100%; border-collapse: collapse; margin: 0 0 1.5rem; font-size: var(--font-size-sm); border: 1px solid var(--docs-border-color); border-radius: var(--radius-md); overflow: hidden; }
.docs-article-content th, .docs-article-content td { padding: 0.7rem 1rem; text-align: left; border-bottom: 1px solid var(--docs-border-color); }
.docs-article-content thead th { background: var(--docs-bg-tertiary); color: var(--docs-text-primary); font-weight: 600; }
.docs-article-content tbody tr:last-child td { border-bottom: none; }

/* ───────────────────────── FEEDBACK WIDGET ───────────────────────── */
.docs-feedback { margin-top: 3.5rem; padding: 1.75rem; border: 1px solid var(--docs-border-color); border-radius: var(--radius-lg); background: var(--docs-bg-tertiary); text-align: center; }
.docs-feedback h4 { font-size: 1.05rem; font-weight: 700; color: var(--docs-text-primary); margin: 0 0 1rem; }
.docs-feedback .btn-group { display: inline-flex; gap: 0.75rem; }
.docs-feedback .feedback-toggle {
  display: inline-flex;
  align-items: center;
  gap: 0.4rem;
  padding: 0.55rem 1.4rem;
  border-radius: var(--radius-md);
  font-size: var(--font-size-sm);
  font-weight: 600;
  cursor: pointer;
  background: var(--docs-bg-primary);
  border: 1px solid var(--docs-border-strong);
  transition: transform var(--transition-fast), border-color var(--transition-fast), color var(--transition-fast), background var(--transition-fast);
}
.docs-feedback .btn-outline-success { color: var(--primary-green, #10b981); }
.docs-feedback .btn-outline-success:hover { transform: translateY(-2px); border-color: var(--primary-green, #10b981); background: rgba(16, 185, 129, 0.1); }
.docs-feedback .btn-outline-danger { color: var(--primary-red, #ef4444); }
.docs-feedback .btn-outline-danger:hover { transform: translateY(-2px); border-color: var(--primary-red, #ef4444); background: rgba(239, 68, 68, 0.1); }
.docs-feedback .form-label { display: block; text-align: left; font-size: var(--font-size-sm); font-weight: 600; color: var(--docs-text-primary); margin-bottom: 0.4rem; }
.docs-feedback .form-control { width: 100%; border-radius: var(--radius-md); border: 1px solid var(--docs-input-border); background: var(--docs-input-bg); color: var(--docs-text-primary); padding: 0.7rem 0.9rem; font-size: var(--font-size-sm); }
.docs-feedback .form-control:focus { outline: none; border-color: var(--docs-accent); box-shadow: 0 0 0 4px var(--docs-accent-ring); }
.docs-feedback .feedback-form { text-align: left; max-width: 480px; margin: 1.25rem auto 0; }
.docs-feedback .btn-primary { display: inline-flex; align-items: center; gap: 0.4rem; padding: 0.6rem 1.4rem; border: none; border-radius: var(--radius-md); font-weight: 600; color: #fff; background: var(--docs-grad); cursor: pointer; box-shadow: 0 6px 16px -6px rgba(37, 99, 235, 0.55); }
.docs-feedback .alert-success { padding: 0.85rem 1.1rem; border-radius: var(--radius-md); background: rgba(16, 185, 129, 0.12); color: #0f9d6b; font-size: var(--font-size-sm); font-weight: 500; }
[data-theme="dark"] .docs-feedback .alert-success { color: #34d399; }
.d-none { display: none !important; }

/* ───────────────────────── RELATED + PREV/NEXT ───────────────────────── */
.docs-related { margin-top: 3rem; }
.docs-related h4, .docs-category h2, .docs-search-results-heading { font-size: 1.2rem; font-weight: 700; letter-spacing: -0.01em; color: var(--docs-text-primary); margin: 0 0 1rem; }
/* reusable card grid */
.docs-card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
  gap: 1rem;
}
@media (max-width: 575px) { .docs-card-grid { grid-template-columns: 1fr; } }

.docs-article-card {
  display: flex;
  flex-direction: column;
  padding: 1.25rem 1.4rem;
  border: 1px solid var(--docs-border-color);
  border-radius: var(--radius-lg);
  background: var(--docs-bg-primary);
  box-shadow: var(--shadow-sm);
  text-decoration: none;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
}
.docs-article-card:hover { transform: translateY(-3px); box-shadow: var(--shadow-lg); border-color: var(--docs-accent-ring); }
.docs-article-card h5 { font-size: 1rem; font-weight: 600; margin: 0 0 0.4rem; letter-spacing: -0.01em; color: var(--docs-text-primary); }
.docs-article-card:hover h5 { color: var(--docs-accent-strong); }
[data-theme="dark"] .docs-article-card:hover h5 { color: #7dd3fc; }
.docs-article-card p { font-size: var(--font-size-sm); line-height: 1.55; color: var(--docs-text-secondary); margin: 0 0 0.75rem; }
.docs-article-card .text-muted { color: var(--docs-text-muted); }

.docs-nav-prev-next { margin-top: 3rem; padding-top: 2rem; border-top: 1px solid var(--docs-border-color); }
.docs-nav-link {
  display: flex;
  align-items: center;
  gap: 0.85rem;
  height: 100%;
  padding: 1.1rem 1.3rem;
  border: 1px solid var(--docs-border-color);
  border-radius: var(--radius-lg);
  background: var(--docs-bg-primary);
  text-decoration: none;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
}
.docs-nav-link:hover { transform: translateY(-2px); box-shadow: var(--shadow-md); border-color: var(--docs-accent-ring); }
.docs-nav-link i { color: var(--docs-accent); }
.docs-nav-link > div { display: flex; flex-direction: column; min-width: 0; }
.docs-nav-label { font-size: var(--font-size-xs); font-weight: 700; text-transform: uppercase; letter-spacing: 0.06em; color: var(--docs-text-muted); margin-bottom: 0.15rem; }
.docs-nav-title { font-size: var(--font-size-sm); font-weight: 600; color: var(--docs-text-primary); overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }

/* ───────────────────────── CATEGORY / SEARCH / TAG / AUDIENCE ───────────────────────── */
.docs-category > h1, .docs-content > h1 {
  font-size: clamp(1.9rem, 3.5vw, 2.4rem);
  font-weight: 700;
  letter-spacing: -0.03em;
  color: var(--docs-text-primary);
  margin: 0 0 0.75rem;
  text-wrap: balance;
}
.docs-category .lead, .docs-page-lead {
  font-size: var(--font-size-lg);
  line-height: 1.6;
  color: var(--docs-text-secondary);
  margin: 0 0 2rem;
  max-width: 680px;
}
.docs-category h2 { margin-top: 2.5rem; }

/* generic responsive card grid */
.docs-card-grid { display: grid; grid-template-columns: repeat(auto-fill, minmax(300px, 1fr)); gap: 1rem; }

/* search box */
.docs-search-box { position: relative; margin-bottom: 2rem; }
.docs-search-input-wrapper {
  display: flex;
  border-radius: var(--radius-lg);
  background: var(--docs-input-bg);
  border: 1px solid var(--docs-input-border);
  box-shadow: var(--shadow-md);
  overflow: hidden;
  transition: border-color var(--transition-base), box-shadow var(--transition-base);
}
.docs-search-input-wrapper:focus-within { border-color: var(--docs-accent); box-shadow: 0 0 0 4px var(--docs-accent-ring); }
.docs-search-input-wrapper .form-control { flex: 1; border: none; background: transparent; padding: 0.85rem 1.1rem; font-size: 1rem; color: var(--docs-text-primary); }
.docs-search-input-wrapper .form-control:focus { outline: none; box-shadow: none; }
.docs-search-input-wrapper .form-control::placeholder { color: var(--docs-text-muted); }
.docs-search-input-wrapper .btn-primary { display: inline-flex; align-items: center; gap: 0.4rem; margin: 5px; padding: 0.55rem 1.3rem; border: none; border-radius: var(--radius-md); font-weight: 600; color: #fff; background: var(--docs-grad); cursor: pointer; }
.docs-search-dropdown {
  position: absolute;
  top: calc(100% + 0.5rem);
  left: 0;
  right: 0;
  z-index: 60;
  background: var(--docs-bg-primary);
  border: 1px solid var(--docs-border-color);
  border-radius: var(--radius-md);
  box-shadow: var(--shadow-lg);
  overflow: hidden;
  display: none;
}
.docs-search-dropdown.open { display: block; }
.docs-search-dropdown a { display: block; padding: 0.7rem 1rem; font-size: var(--font-size-sm); color: var(--docs-text-secondary); text-decoration: none; border-bottom: 1px solid var(--docs-border-color); }
.docs-search-dropdown a:last-child { border-bottom: none; }
.docs-search-dropdown a:hover, .docs-search-dropdown a.active { background: var(--docs-accent-soft); color: var(--docs-accent-strong); }

/* search results */
.docs-search-result {
  display: block;
  padding: 1.25rem 1.5rem;
  margin-bottom: 1rem;
  border: 1px solid var(--docs-border-color);
  border-radius: var(--radius-lg);
  background: var(--docs-bg-primary);
  box-shadow: var(--shadow-sm);
  text-decoration: none;
  transition: transform var(--transition-base), box-shadow var(--transition-base), border-color var(--transition-base);
}
.docs-search-result:hover { transform: translateY(-2px); box-shadow: var(--shadow-md); border-color: var(--docs-accent-ring); }
.docs-search-result h5 { font-size: 1.05rem; font-weight: 600; color: var(--docs-text-primary); margin: 0 0 0.3rem; }
.docs-search-result:hover h5 { color: var(--docs-accent-strong); }
[data-theme="dark"] .docs-search-result:hover h5 { color: #7dd3fc; }
.docs-search-category { display: inline-block; font-size: var(--font-size-xs); font-weight: 700; letter-spacing: 0.04em; text-transform: uppercase; color: var(--docs-accent-strong); margin-bottom: 0.4rem; }
[data-theme="dark"] .docs-search-category { color: #7dd3fc; }
.docs-search-result p { font-size: var(--font-size-sm); line-height: 1.55; color: var(--docs-text-secondary); margin: 0.3rem 0 0; }
.docs-content > h2 { font-size: 1.2rem; font-weight: 700; color: var(--docs-text-primary); margin: 2rem 0 1rem; }
.docs-content > h2:first-of-type { margin-top: 0; }

/* pagination */
.docs-pagination { display: flex; flex-wrap: wrap; gap: 0.4rem; justify-content: center; margin-top: 2rem; }
.docs-pagination a, .docs-pagination span {
  display: inline-grid;
  place-items: center;
  min-width: 38px;
  height: 38px;
  padding: 0 0.6rem;
  border-radius: var(--radius-md);
  border: 1px solid var(--docs-border-color);
  background: var(--docs-bg-primary);
  color: var(--docs-text-secondary);
  font-size: var(--font-size-sm);
  font-weight: 600;
  text-decoration: none;
  transition: background var(--transition-fast), color var(--transition-fast), border-color var(--transition-fast);
}
.docs-pagination a:hover { background: var(--docs-accent-soft); color: var(--docs-accent-strong); border-color: var(--docs-accent-ring); }
.docs-pagination .active { background: var(--docs-grad); color: #fff; border-color: transparent; }

/* empty + back link */
.docs-empty {
  display: flex;
  align-items: center;
  gap: 0.6rem;
  padding: 1.25rem 1.5rem;
  border: 1px dashed var(--docs-border-strong);
  border-radius: var(--radius-md);
  background: var(--docs-bg-tertiary);
  color: var(--docs-text-secondary);
  font-size: var(--font-size-sm);
}
.docs-empty i { color: var(--docs-accent); }
.docs-content .docs-back-link {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  width: auto;
  height: auto;
  padding: 0;
  border: none;
  font-size: var(--font-size-sm);
  font-weight: 600;
  color: var(--docs-accent-strong);
  text-decoration: none;
}
[data-theme="dark"] .docs-content .docs-back-link { color: #7dd3fc; }
.docs-content .docs-back-link:hover { text-decoration: underline; }

/* ───────────────────────── BOOTSTRAP ROW/COL FALLBACK ───────────────────────── */
.docs-content .row { display: grid; grid-template-columns: repeat(2, 1fr); gap: 1rem; }
.docs-content .row.g-3 { gap: 1rem; }
.docs-content .col-md-6, .docs-content .col-6 { min-width: 0; }

/* ───────────────────────── RESPONSIVE ───────────────────────── */
@media (max-width: 991px) {
  .docs-container { flex-direction: column; }
  .docs-toc:not(.docs-index-sidebar) { display: none; }
  .docs-index-sidebar { width: 100%; position: static; flex-direction: row; flex-wrap: wrap; }
  .docs-index-sidebar .docs-sidebar-card { flex: 1 1 280px; }
  .docs-toc-inline { display: block; }
  .docs-header-inner { display: flex; }
  .docs-content .row { grid-template-columns: 1fr; }
}
@media (max-width: 575px) {
  .audience-cards, .category-grid { grid-template-columns: 1fr; }
  .docs-article-header { flex-direction: column; align-items: flex-start; }
}

@media (prefers-reduced-motion: reduce) {
  * { transition-duration: 0.01ms !important; }
}