/* ==========================================================================
   FlexNet BEM Starter — BASE STRUCTURE (Token Exchange Architecture)
   
   THIS FILE CONTAINS:
   - All BEM class definitions
   - All layout rules
   - All component patterns
   - CSS variable REFERENCES only (var(--token-name))
   
   THIS FILE DOES NOT CONTAIN:
   - Design token definitions
   - Color values
   - Shadow definitions
   - Gradient definitions
   
   LOAD ORDER: 
   1. THIS FILE (bem-starter-base.css)
   2. ONE THEME FILE (theme-*.css)
   ========================================================================== */

/* == 0) Reset / Base ====================================================== */
*, *::before, *::after { box-sizing: border-box; }
html { -webkit-text-size-adjust: 100%; height: 100%; }
body {
  margin: 0; height: 100%;
  font: 400 16px/1.65 system-ui, -apple-system, Segoe UI, Roboto, Ubuntu, Cantarell, Noto Sans, Helvetica, Arial, "Apple Color Emoji", "Segoe UI Emoji";
  color: var(--color-fg); 
  background: var(--color-bg);
  text-rendering: optimizeLegibility;
  -webkit-font-smoothing: antialiased; 
  -moz-osx-font-smoothing: grayscale;
}
img, svg, video, canvas, iframe { display: block; max-width: 100%; height: auto; }
button, input, select, textarea { font: inherit; color: inherit; }
:focus-visible { outline: 2px solid color-mix(in srgb, var(--color-primary) 60%, transparent); outline-offset: 2px; }

/* == 1) Layout Tokens (non-visual) ======================================= */
:root {
  --header-h: 92px;
  --header-pad-y: 12px;
  --header-pad-x: clamp(18px, 4.5vw, 44px);
  --logo-h: 68px;
  --brand-gap: 8px;
  --brand-nudge: 20px;
  --header-gap-below: clamp(36px, 5vh, 56px);
  --layout-gap: clamp(22px, 3vw, 36px);
  --stack-top: clamp(10px, 1.2vh, 18px);
  --radius-sm: .375rem; 
  --radius-md: .625rem; 
  --radius-lg: .875rem; 
  --radius-xl: 1.25rem;
  --z-header: 100;
  --z-overlay: 900;
}

/* == 2) Page Shell ======================================================== */
.c-doc-layout { 
  min-height: 100svh; 
  background: var(--bg-gradient);
  background-attachment: fixed;
  background-size: cover;
  background-repeat: no-repeat;
}

/* == 3) Header (fixed, full-width) ======================================= */
.c-doc-header {
  position: fixed; 
  inset: 0 0 auto 0;
  height: var(--header-h);
  z-index: var(--z-header);
  background: var(--header-gradient);
  backdrop-filter: var(--backdrop-filter);
  border-bottom: 1px solid color-mix(in srgb, var(--color-border) 75%, transparent);
  box-shadow: var(--header-shadow);
}

.c-doc-header__inner {
  height: 100%;
  display: flex;
  align-items: center;
  gap: max(0px, var(--brand-gap));
  padding: var(--header-pad-y) var(--header-pad-x);
}

.c-doc-header__logo {
  flex: 0 0 auto;
  display: flex;
  align-items: center;
  text-decoration: none;
}
.c-doc-header__logo img { 
  display: block; 
  height: var(--logo-h); 
  width: auto; 
  filter: var(--logo-filter);
}

.c-doc-header__brand {
  flex: 0 1 auto;
  display: flex;
  flex-direction: column;
  justify-content: center;
  min-width: 0;
  white-space: nowrap;
  margin-left: var(--brand-nudge);
}
.c-doc-header__title {
  margin: 0; 
  font-weight: 800; 
  letter-spacing: .2px; 
  line-height: 1;
  font-size: clamp(22px, 2.2vw + 10px, 34px);
  text-shadow: var(--text-shadow-primary);
}
.c-doc-header__subtitle {
  margin: 2px 0 0 0; 
  color: var(--color-fg-muted);
  font-size: .95rem; 
  line-height: 1.05; 
  white-space: nowrap;
}

.c-doc-header__nav { 
  margin-left: auto; 
  display: flex; 
  align-items: center; 
  gap: clamp(12px, 2vw, 28px); 
}
.c-doc-header__link { 
  text-decoration: none; 
  color: var(--color-fg-muted); 
  font-weight: 500; 
  transition: color .2s ease, text-shadow .2s ease;
}
.c-doc-header__link[aria-current="page"], 
.c-doc-header__link:hover { 
  color: var(--color-fg); 
  text-shadow: var(--text-shadow-accent);
}
.c-doc-header__link.is-active {
  color: var(--color-fg); 
  text-shadow: var(--text-shadow-accent);
}

/* Hamburger menu button */
.c-doc-header__hamburger {
  display: none;
  flex-direction: column;
  justify-content: center;
  align-items: center;
  width: 44px;
  height: 44px;
  padding: 0;
  margin-left: auto;
  background: transparent;
  border: none;
  cursor: pointer;
  z-index: calc(var(--z-overlay) + 10);
}

.c-doc-header__hamburger-line {
  display: block;
  width: 24px;
  height: 2px;
  background: var(--color-fg);
  border-radius: 2px;
  transition: transform 0.3s ease, opacity 0.3s ease;
}

.c-doc-header__hamburger-line + .c-doc-header__hamburger-line {
  margin-top: 6px;
}

/* Hamburger open state */
.c-doc-header__hamburger.is-open .c-doc-header__hamburger-line:nth-child(1) {
  transform: translateY(8px) rotate(45deg);
}

.c-doc-header__hamburger.is-open .c-doc-header__hamburger-line:nth-child(2) {
  opacity: 0;
}

.c-doc-header__hamburger.is-open .c-doc-header__hamburger-line:nth-child(3) {
  transform: translateY(-8px) rotate(-45deg);
}

/* Mobile navigation overlay */
.c-mobile-nav {
  position: fixed;
  top: 0;
  right: 0;
  bottom: 0;
  width: min(320px, 85vw);
  background: var(--header-gradient);
  backdrop-filter: var(--backdrop-filter);
  border-left: 1px solid color-mix(in srgb, var(--color-border) 75%, transparent);
  box-shadow: -4px 0 20px rgba(0, 0, 0, 0.3);
  z-index: var(--z-overlay);
  transform: translateX(100%);
  transition: transform 0.3s ease;
  display: flex;
  flex-direction: column;
  padding: calc(var(--header-h) + 20px) 24px 24px;
  overflow-y: auto;
}

.c-mobile-nav.is-open {
  transform: translateX(0);
}

/* Mobile nav backdrop */
.c-mobile-nav-backdrop {
  position: fixed;
  inset: 0;
  background: rgba(0, 0, 0, 0.5);
  z-index: calc(var(--z-overlay) - 1);
  opacity: 0;
  visibility: hidden;
  transition: opacity 0.3s ease, visibility 0.3s ease;
}

.c-mobile-nav-backdrop.is-visible {
  opacity: 1;
  visibility: visible;
}

/* Mobile nav links */
.c-mobile-nav__link {
  display: block;
  padding: 16px 0;
  color: var(--color-fg-muted);
  text-decoration: none;
  font-size: 1.1rem;
  font-weight: 500;
  border-bottom: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  transition: color 0.2s ease;
}

.c-mobile-nav__link:first-child {
  border-top: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
}

.c-mobile-nav__link:hover,
.c-mobile-nav__link.is-active {
  color: var(--color-fg);
}

.c-mobile-nav__section-title {
  margin: 24px 0 8px;
  font-size: 0.75rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 1px;
  color: var(--color-fg-muted);
}

/* == 4) Main band ======================================================== */
.c-doc-layout__main {
  display: grid;
  grid-template-columns: minmax(240px, 300px) 1fr;
  gap: var(--layout-gap);
  padding-inline: var(--header-pad-x);
  padding-top: calc(var(--header-h) + var(--header-gap-below));
  padding-bottom: clamp(40px, 6vh, 72px);
  transition: grid-template-columns 0.3s ease;
}

/* Collapsed sidebar state */
.c-doc-layout__main.is-sidebar-collapsed {
  grid-template-columns: 0 1fr;
  gap: 0;
}

.c-doc-layout__main.is-sidebar-collapsed .c-sidebar {
  width: 0;
  min-width: 0;
  padding: 0;
  opacity: 0;
  overflow: hidden;
  border: none;
  pointer-events: none;
}

/* == 5) Sidebar ========================================================== */
.c-sidebar {
  position: sticky; 
  top: calc(var(--header-h) + var(--header-gap-below)); 
  align-self: start;
  background: var(--panel-gradient), linear-gradient(180deg, rgba(255,255,255,.02), rgba(255,255,255,0));
  border: 1px solid color-mix(in srgb, var(--color-border) 78%, transparent);
  border-radius: var(--radius-xl); 
  box-shadow: var(--panel-shadow);
  padding: clamp(16px, 2.4vw, 22px);
  transition: width 0.3s ease, opacity 0.3s ease, padding 0.3s ease;
}

/* Sidebar toggle button (expand button - shown when collapsed) */
.c-sidebar-toggle {
  position: fixed;
  left: var(--header-pad-x);
  top: calc(var(--header-h) + var(--header-gap-below));
  z-index: 50;
  width: 36px;
  height: 36px;
  border-radius: var(--radius-md);
  background: var(--color-bg-elev);
  border: 1px solid var(--color-border);
  color: var(--color-fg-muted);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  box-shadow: var(--shadow-sm);
  transition: opacity 0.3s ease, transform 0.3s ease, background 0.2s ease, color 0.2s ease;
  opacity: 0;
  pointer-events: none;
  transform: translateX(-10px);
}

.c-sidebar-toggle:hover {
  background: var(--color-primary);
  color: var(--color-primary-contrast);
}

.c-sidebar-toggle svg {
  width: 20px;
  height: 20px;
}

/* Show expand button when sidebar is collapsed */
.c-doc-layout__main.is-sidebar-collapsed + .c-sidebar-toggle {
  opacity: 1;
  pointer-events: auto;
  transform: translateX(0);
}

/* Toggle button inside sidebar header */
.c-sidebar__header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  margin-bottom: 6px;
}

.c-sidebar__collapse-btn {
  width: 28px;
  height: 28px;
  border-radius: var(--radius-sm);
  background: transparent;
  border: none;
  color: var(--color-fg-muted);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: background 0.2s ease, color 0.2s ease;
  flex-shrink: 0;
}

.c-sidebar__collapse-btn:hover {
  background: color-mix(in srgb, var(--color-primary) 20%, transparent);
  color: var(--color-fg);
}

.c-sidebar__collapse-btn svg {
  width: 18px;
  height: 18px;
}
.c-sidebar__nav { 
  display: flex; 
  flex-direction: column; 
  gap: 0; 
}
.c-sidebar__title { 
  margin: 0; 
  font-weight: 700; 
  color: var(--color-fg); 
  letter-spacing: .2px; 
  line-height: 1.05; 
  text-shadow: var(--text-shadow-accent);
}
.c-sidebar__title + .c-sidebar__items { margin-top: 6px; }
.c-sidebar__items { 
  list-style: disc; 
  padding-left: 20px; 
  margin: 0; 
  color: var(--color-fg-muted); 
}
.c-sidebar__item + .c-sidebar__item { margin-top: 10px; }
.c-sidebar__link { 
  color: var(--color-primary); 
  text-decoration: none; 
  transition: color .2s ease, text-shadow .2s ease;
}
.c-sidebar__link:hover { 
  text-decoration: underline; 
  text-shadow: var(--text-shadow-accent);
}
.c-sidebar > * { 
  background: transparent; 
  box-shadow: none; 
  border: 0; 
}

/* == 5a) Sidebar Pills ==================================================== */
.c-pill-group {
  list-style: none;
  padding: 0;
  margin: 10px 0 0 0;
  display: flex;
  flex-direction: column;
  gap: 10px;
}

.c-pill-group__item { margin: 0; }

.c-pill {
  --_bg: color-mix(in srgb, var(--color-bg-elev) 92%, transparent);
  --_bd: color-mix(in srgb, var(--color-border) 92%, transparent);
  --_fg: var(--color-fg);

  display: block;
  text-decoration: none;
  user-select: none;
  padding: 10px 14px;
  border-radius: 9999px;
  background: var(--_bg);
  border: 1px solid var(--_bd);
  color: var(--_fg);
  box-shadow: var(--shadow-sm);
  transition: transform .15s ease, box-shadow .2s ease, background .2s ease, border-color .2s ease, color .2s ease;
}

.c-pill__label {
  display: inline-block;
  font-weight: 600;
  letter-spacing: .2px;
  line-height: 1.1;
}

.c-pill:hover,
.c-pill:focus-visible {
  border-color: color-mix(in srgb, var(--color-primary) 55%, var(--color-border));
  box-shadow: var(--pill-hover-shadow);
  transform: translateY(-1px);
}

.c-pill--active {
  --_bg: var(--pill-active-bg);
  --_bd: color-mix(in srgb, var(--color-primary) 82%, var(--color-border));
  --_fg: var(--color-primary-contrast);
  color: var(--_fg);
  box-shadow: var(--pill-active-shadow);
}

[data-theme="light"] .c-pill { --_bg: #ffffff; }

/* == 6) Content ========================================================== */
.c-doc-layout__content { 
  min-width: 0; 
}

.c-doc-layout__content-inner { 
  max-width: 1100px; 
  margin-inline: auto; 
}

.c-doc-content {
  background: var(--panel-gradient), linear-gradient(180deg, rgba(255,255,255,.02), rgba(255,255,255,0));
  border: 1px solid color-mix(in srgb, var(--color-border) 78%, transparent);
  border-radius: var(--radius-xl); 
  box-shadow: var(--panel-shadow);
  padding: clamp(28px, 5vw, 56px);
  margin-top: var(--stack-top);
}

.c-doc-content > section {
  margin-bottom: clamp(2rem, 4vw, 3rem);
}

.c-doc-content > section:last-child {
  margin-bottom: 0;
}

.c-doc-content h1 {
  margin: 0 0 1rem 0;
  font-weight: 800;
  font-size: clamp(28px, 2.4vw + 16px, 48px);
  letter-spacing: .3px;
  line-height: 1.1;
  color: var(--color-fg);
  text-shadow: var(--hero-title-shadow);
}

.c-doc-content h2 {
  margin: 2rem 0 1rem 0;
  font-weight: 700;
  font-size: clamp(20px, 1.5vw + 14px, 32px);
  color: var(--color-fg);
}

.c-doc-content h3 {
  margin: 1.5rem 0 0.75rem 0;
  font-weight: 600;
  font-size: clamp(16px, 1vw + 12px, 24px);
  color: var(--color-fg);
}

.c-doc-content p {
  margin: 0 0 1rem 0;
  line-height: 1.7;
  color: var(--color-fg-muted);
}

.c-doc-content code {
  padding: 0.2em 0.4em;
  background: color-mix(in srgb, var(--color-primary) 15%, transparent);
  border-radius: var(--radius-sm);
  font-size: 0.9em;
  font-family: 'Monaco', 'Courier New', monospace;
}

.c-doc-content pre {
  background: color-mix(in srgb, var(--color-bg) 50%, transparent);
  border: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  border-radius: var(--radius-md);
  padding: 1rem;
  overflow-x: auto;
  margin: 1rem 0;
}

.c-doc-content pre code {
  background: none;
  padding: 0;
}

.c-doc-content .o-stack {
  display: flex;
  flex-direction: column;
  gap: 1.5rem;
}

.c-doc-content .doc-card {
  background: color-mix(in srgb, var(--color-bg-elev) 30%, transparent);
  border: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  border-radius: var(--radius-lg);
  padding: clamp(2rem, 4vw, 3rem);
  margin: 1rem 0;
}

.c-doc-content .doc-card h3 {
  margin-top: 0;
  margin-bottom: 1.25rem;
}

.c-doc-content .doc-card p {
  margin-bottom: 0;
}

.c-doc-content .doc-grid {
  display: grid;
  gap: 1.5rem;
  margin: 1rem 0;
}

.c-doc-content .doc-grid--2 {
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
}

.c-doc-content .doc-list {
  margin: 0.5rem 0;
  padding-left: 1.5rem;
  color: var(--color-fg-muted);
}

.c-doc-content .doc-list li {
  margin: 0.5rem 0;
  line-height: 1.6;
}

.c-doc-content a {
  color: var(--color-primary);
  text-decoration: none;
  transition: color 0.2s ease;
}

.c-doc-content a:hover {
  text-decoration: underline;
}

/* == 7) Hero ============================================================= */
.c-hero {
  margin-top: calc(var(--stack-top) + 2px);
  background: var(--panel-gradient), linear-gradient(180deg, rgba(255,255,255,.02), rgba(255,255,255,0));
  border: 1px solid color-mix(in srgb, var(--color-border) 78%, transparent);
  border-radius: var(--radius-xl); 
  box-shadow: var(--panel-shadow);
  padding: clamp(18px, 3.5vw, 28px) clamp(18px, 4vw, 36px);
}
.c-hero__title {
  margin: 0 0 10px 0; 
  font-weight: 800;
  font-size: clamp(28px, 2.4vw + 16px, 56px); 
  letter-spacing: .3px; 
  line-height: 1.1;
  color: var(--color-fg); 
  text-shadow: var(--hero-title-shadow);
}
.c-hero__subtitle { 
  margin: 0 0 18px 0; 
  color: var(--color-fg-muted); 
  font-size: clamp(14px, .35vw + 14px, 18px); 
}
.c-hero__actions { 
  display: flex; 
  gap: 14px; 
  flex-wrap: wrap; 
}

/* == 8) Buttons ========================================================== */
.c-button {
  --_bg: var(--color-primary); 
  --_fg: var(--color-primary-contrast); 
  --_bd: transparent;
  display: inline-flex; 
  align-items: center; 
  justify-content: center; 
  gap: .5rem;
  padding: .6rem 1rem; 
  border-radius: 999px;
  border: 1px solid var(--_bd); 
  background: var(--_bg); 
  color: var(--_fg);
  text-decoration: none; 
  cursor: pointer;
  box-shadow: var(--button-shadow);
  transition: transform .06s ease, box-shadow .2s ease, background .2s ease, color .2s ease, border-color .2s ease;
}
.c-button:hover { 
  transform: translateY(-1px); 
  box-shadow: var(--button-hover-shadow); 
}
.c-button:active { 
  transform: none; 
  box-shadow: var(--button-active-shadow); 
}
.c-button--ghost { 
  --_bg: transparent; 
  --_fg: var(--color-primary); 
  --_bd: color-mix(in srgb, var(--color-primary) 70%, var(--color-border)); 
  box-shadow: none; 
}
.c-button--secondary { 
  --_bg: var(--button-secondary-bg); 
  box-shadow: var(--button-secondary-shadow);
}
.c-button--secondary:hover {
  box-shadow: var(--button-secondary-hover-shadow);
}

/* == 9) Cards, Alerts, Tables =========================================== */
.c-card { 
  background: var(--color-bg-elev); 
  border: 1px solid var(--color-border); 
  border-radius: var(--radius-lg); 
  box-shadow: var(--shadow-md); 
  overflow: hidden; 
}
.c-card__header, .c-card__body, .c-card__footer { padding: 16px 18px; }
.c-card__header { 
  font-weight: 700; 
  border-bottom: 1px solid var(--color-border); 
}
.c-card__footer { 
  border-top: 1px solid var(--color-border); 
}

/* Cards inside doc content get padding directly */
.c-doc-content .c-card {
  padding: clamp(2rem, 4vw, 3rem);
}
.c-doc-content .c-card h3 {
  margin-top: 0;
  margin-bottom: 1.25rem;
}
.c-doc-content .c-card p:last-child {
  margin-bottom: 0;
}

/* Cards grid layout */
.c-cards-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
  gap: clamp(1rem, 2vw, 1.5rem);
}
.c-cards-grid .c-card {
  height: 100%;
}

.c-alert { 
  border: 1px solid var(--color-border); 
  border-left-width: 4px; 
  padding: 12px 16px; 
  border-radius: var(--radius-md); 
  background: color-mix(in srgb, var(--color-bg) 94%, transparent); 
}
.c-alert--success { 
  border-left-color: var(--color-success); 
  box-shadow: var(--alert-success-shadow); 
}
.c-alert--warning { 
  border-left-color: var(--color-warning); 
  box-shadow: var(--alert-warning-shadow); 
}
.c-alert--danger { 
  border-left-color: var(--color-danger); 
  box-shadow: var(--alert-danger-shadow); 
}
.c-alert__title { 
  font-weight: 700; 
  margin: 0 0 4px; 
}
.c-alert__desc { 
  color: var(--color-fg-muted); 
  margin: 0; 
}

/* Callout boxes */
.c-callout {
  background: color-mix(in srgb, var(--color-bg-elev) 40%, transparent);
  border: 1px solid color-mix(in srgb, var(--color-border) 60%, transparent);
  border-left: 4px solid var(--color-primary);
  border-radius: var(--radius-md);
  padding: clamp(1.5rem, 3vw, 2.5rem);
  margin: 1rem 0;
}
.c-callout--principle {
  border-left-color: var(--color-primary);
}
.c-callout p {
  margin: 0;
}

/* Principle cards */
.c-principle {
  background: color-mix(in srgb, var(--color-bg-elev) 30%, transparent);
  border: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  border-radius: var(--radius-lg);
  padding: clamp(2rem, 4vw, 3rem);
  margin: 0.75rem 0;
}
.c-principle h3 {
  margin-top: 0;
  margin-bottom: 1rem;
}
.c-principle p:last-child {
  margin-bottom: 0;
}

/* Diagram containers */
.c-diagram {
  background: color-mix(in srgb, var(--color-bg) 80%, transparent);
  border: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  border-radius: var(--radius-lg);
  padding: clamp(2rem, 4vw, 3rem);
  margin: 1rem 0;
  overflow-x: auto;
}
.c-diagram pre {
  margin: 0;
  font-size: 0.85rem;
  line-height: 1.4;
}

/* Table wrapper */
.c-table-wrapper {
  background: color-mix(in srgb, var(--color-bg-elev) 30%, transparent);
  border: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  border-radius: var(--radius-lg);
  padding: clamp(1.5rem, 3vw, 2rem);
  margin: 1rem 0;
  overflow-x: auto;
}

.c-table { 
  width: 100%; 
  border-collapse: collapse; 
  border: 1px solid var(--color-border); 
  border-radius: var(--radius-md); 
  overflow: hidden; 
}
.c-table th, .c-table td { 
  padding: 12px 16px; 
  border-bottom: 1px solid var(--color-border); 
}
.c-table thead th { 
  text-align: left; 
  color: var(--color-fg-muted); 
  background: color-mix(in srgb, var(--color-bg) 92%, transparent); 
  text-shadow: var(--text-shadow-accent);
}

/* == 10) Tabs ============================================================ */
.c-tabs { 
  display: grid; 
  gap: 10px; 
}
.c-tabs__list { 
  display: flex; 
  gap: 8px; 
  border-bottom: 1px solid var(--color-border); 
}
.c-tabs__tab { 
  appearance: none; 
  background: transparent; 
  border: none; 
  padding: 8px 10px; 
  border-bottom: 2px solid transparent; 
  cursor: pointer; 
  color: var(--color-fg-muted); 
  transition: color .2s ease, border-color .2s ease, text-shadow .2s ease;
}
.c-tabs__tab[aria-selected="true"] { 
  color: var(--color-fg); 
  border-bottom-color: var(--color-primary); 
  text-shadow: var(--text-shadow-accent);
}
.c-tabs__tab:hover { 
  text-shadow: var(--text-shadow-accent); 
}
.c-tabs__panel { display: none; }
.c-tabs__panel[aria-hidden="false"] { display: block; }

/* == 11) Documentation Content ========================================== */
.c-doc-content { max-width: none; }
.c-doc-content h1 { 
  font-size: clamp(28px, 2.2vw + 14px, 44px); 
  line-height: 1.2; 
  margin: 0 0 12px; 
  font-weight: 800; 
  color: var(--color-fg); 
  text-shadow: var(--text-shadow-accent);
}
.c-doc-content h2 { 
  font-size: clamp(22px, 1.4vw + 12px, 28px); 
  line-height: 1.3; 
  margin: clamp(2rem, 4vw, 3rem) 0 1rem; 
  font-weight: 700; 
  border-bottom: 2px solid color-mix(in srgb, var(--color-primary) 55%, transparent); 
  padding-bottom: 8px; 
  text-shadow: var(--text-shadow-accent);
}
.c-doc-content h2:first-child {
  margin-top: 0;
}
.c-doc-content h3 { 
  font-size: clamp(18px, .9vw + 12px, 22px); 
  margin: 1.5rem 0 0.75rem; 
  font-weight: 700; 
  text-shadow: var(--text-shadow-accent);
}
.c-doc-content p, .c-doc-content ul, .c-doc-content ol { 
  color: var(--color-fg-muted);
  margin-bottom: 1.25rem;
}
.c-doc-content p:last-child {
  margin-bottom: 0;
}
.c-doc-content code { 
  background: color-mix(in srgb, var(--color-bg) 90%, transparent); 
  color: var(--code-color); 
  padding: .125rem .375rem; 
  border-radius: var(--radius-sm); 
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace; 
  font-size: .9em; 
  box-shadow: var(--code-shadow);
}

/* == 12) Footer ========================================================== */
.c-footer { 
  border-top: 1px solid color-mix(in srgb, var(--color-border) 75%, transparent); 
  background: transparent; 
}
.c-footer__inner { 
  min-height: 64px; 
  display: flex; 
  align-items: center; 
  justify-content: center; 
  padding: 16px; 
  color: var(--color-fg-muted); 
  text-align: center; 
}

.c-doc-footer {
  margin-top: clamp(24px, 4vw, 64px);
  background: var(--footer-bg);
}

.c-doc-footer__grid {
  background: transparent;
  display: grid;
  grid-template-columns: 1fr;
  gap: clamp(16px, 2vw, 28px);
  max-width: 1100px;
  padding: clamp(20px, 2.4vw, 28px) clamp(20px, 3vw, 36px) clamp(36px, 3vw, 48px);
  margin: 0 auto clamp(22px, 3vw, 36px);
}
@media (min-width: 900px) {
  .c-doc-footer__grid { 
    grid-template-columns: repeat(3, minmax(0, 1fr)); 
    gap: clamp(24px, 3vw, 40px); 
  }
}

.c-doc-footer__section {
  background: transparent;
  border: none;
  border-radius: 0;
  box-shadow: none;
  padding: clamp(8px, 1.5vw, 16px);
}
.c-doc-footer__section-title { 
  margin: 0 0 12px; 
  font-size: 1rem; 
  font-weight: 700; 
  line-height: 1.2; 
}
.c-doc-footer__section-content { 
  font-size: .95rem; 
}

.c-doc-footer__links { 
  list-style: none; 
  padding: 0; 
  margin: 0; 
  display: grid; 
  row-gap: 10px; 
}
.c-doc-footer__link { 
  text-decoration: none; 
  transition: color .2s ease, text-shadow .2s ease, transform .2s ease;
  display: inline-flex;
  align-items: center;
  gap: 6px;
}
.c-doc-footer__link::before {
  content: '›';
  font-size: 1.2em;
  font-weight: 700;
  transition: opacity .2s ease, transform .2s ease;
}
.c-doc-footer__link:hover, 
.c-doc-footer__link:focus { 
  text-decoration: none;
}
.c-doc-footer__link:hover::before,
.c-doc-footer__link:focus::before {
  transform: translateX(3px);
}

.c-doc-footer__top {
  background: var(--footer-bottom-bg);
  width: 100%;
  margin: 0;
  padding: clamp(14px, 2vw, 22px);
  border-bottom: 1px solid color-mix(in srgb, var(--color-border) 75%, transparent);
  text-align: center;
}

.c-doc-footer__bottom {
  background: var(--footer-bottom-bg);
  width: 100%;
  margin: 0;
  padding: clamp(14px, 2vw, 22px);
  border-top: 1px solid color-mix(in srgb, var(--color-border) 75%, transparent);
  text-align: center;
}
.c-doc-footer__copyright { 
  margin: 0; 
  font-size: .9rem; 
  color: var(--color-fg-muted); 
}

/* == 13) Utilities ======================================================= */
.u-hidden { display: none !important; }
.u-flex { display: flex !important; }
.u-items-center { align-items: center !important; }
.u-justify-between { justify-content: space-between !important; }
.u-text-center { text-align: center !important; }
.u-w-full { width: 100% !important; }
.u-rounded-lg { border-radius: var(--radius-lg) !important; }
.u-border { border: 1px solid var(--color-border) !important; }
.u-shadow-sm { box-shadow: var(--shadow-sm) !important; }
.u-mt-0 { margin-top: 0 !important; }
.u-mb-0 { margin-bottom: 0 !important; }
.u-mt-4 { margin-top: 1rem !important; }
.u-mb-4 { margin-bottom: 1rem !important; }
.u-p-4 { padding: 1rem !important; }
.u-space-y-2 > * + * { margin-top: .5rem !important; }
.u-space-y-4 > * + * { margin-top: 1rem !important; }
.u-space-y-6 > * + * { margin-top: 1.5rem !important; }

/* == 14) Reduced Motion ================================================== */
@media (prefers-reduced-motion: reduce) {
  * { 
    animation-duration: .01ms !important; 
    animation-iteration-count: 1 !important; 
    transition-duration: .01ms !important; 
    scroll-behavior: auto !important; 
  }
}

/* == 15) Responsive Tweaks ============================================== */
@media (max-width: 980px) {
  .c-doc-layout__main { grid-template-columns: 1fr; }
  .c-sidebar { order: -1; }
  .c-doc-header__title { font-size: clamp(20px, 5.2vw, 30px); }
  .c-doc-header__subtitle { font-size: .9rem; }
  
  /* Hide desktop nav and theme selector, show hamburger */
  .c-doc-header__nav { display: none; }
  .c-doc-header__theme { display: none; }
  .c-doc-header__hamburger { display: flex; }
  
  /* Adjust header inner for mobile */
  .c-doc-header__inner {
    padding-right: 8px;
  }
}

/* == 16) Admin Panel (STRUCTURE ONLY) ==================================== */
.admin-container {
  max-width: 1200px;
  margin: 0 auto;
  padding: 2rem;
}

.admin-header {
  padding-bottom: 1rem;
  margin-bottom: 2rem;
}

.admin-tabs {
  display: flex;
  gap: 1rem;
  margin-bottom: 2rem;
}

.admin-tab {
  padding: 0.75rem 1.5rem;
  background: none;
  border: none;
  cursor: pointer;
  font-size: 1rem;
  transition: color 0.2s ease, border-color 0.2s ease;
}

.admin-panel {
  display: none;
}

.admin-panel.active {
  display: block;
}

.form-group {
  margin-bottom: 1.5rem;
}

.form-label {
  display: block;
  margin-bottom: 0.5rem;
  font-weight: 600;
}

.form-input,
.form-textarea,
.form-select {
  width: 100%;
  padding: 0.75rem;
  border-radius: var(--radius-sm);
  font-size: 1rem;
  font-family: inherit;
  background-color: var(--color-bg-elev, var(--color-bg));
  color: var(--color-fg);
  border: 1px solid var(--color-border);
}

.form-input::placeholder,
.form-textarea::placeholder {
  color: var(--color-fg-muted, var(--color-fg));
  opacity: 0.6;
}

.form-textarea {
  min-height: 120px;
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
}

.form-input:focus,
.form-textarea:focus,
.form-select:focus {
  outline: none;
}

.btn {
  padding: 0.75rem 1.5rem;
  border: none;
  border-radius: var(--radius-sm);
  cursor: pointer;
  font-size: 1rem;
  font-weight: 600;
  transition: opacity 0.2s ease, background 0.2s ease;
}

.btn-sm {
  padding: 0.5rem 1rem;
  font-size: 0.875rem;
}

.form-actions {
  display: flex;
  gap: 1rem;
  margin-top: 2rem;
}

.item-list {
  border-radius: var(--radius-md);
  margin-bottom: 2rem;
}

.item-list-header {
  padding: 1rem;
  font-weight: 600;
  display: flex;
  justify-content: space-between;
  align-items: center;
}

.item {
  padding: 1rem;
  display: flex;
  justify-content: space-between;
  align-items: center;
}

.item-info {
  flex: 1;
}

.item-title {
  font-weight: 600;
  margin-bottom: 0.25rem;
}

.item-meta {
  font-size: 0.875rem;
}

.item-actions {
  display: flex;
  gap: 0.5rem;
}

/* Page reorder buttons */
.item-reorder {
  display: flex;
  flex-direction: column;
  gap: 2px;
  margin-right: 1rem;
}

.btn-reorder {
  width: 28px;
  height: 20px;
  padding: 0;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-sm);
  background: var(--color-bg-elev);
  color: var(--color-fg-muted);
  cursor: pointer;
  display: flex;
  align-items: center;
  justify-content: center;
  transition: background 0.2s ease, color 0.2s ease, border-color 0.2s ease;
}

.btn-reorder:hover:not(:disabled) {
  background: var(--color-primary);
  color: var(--color-primary-contrast);
  border-color: var(--color-primary);
}

.btn-reorder--disabled,
.btn-reorder:disabled {
  opacity: 0.3;
  cursor: not-allowed;
}

/* Section groups in admin */
.section-group {
  margin-bottom: 1.5rem;
  border: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  border-radius: var(--radius-md);
  overflow: hidden;
}

.section-group__header {
  padding: 0.75rem 1rem;
  font-weight: 700;
  font-size: 0.9rem;
  text-transform: uppercase;
  letter-spacing: 0.5px;
  background: color-mix(in srgb, var(--color-bg-elev) 50%, transparent);
  border-bottom: 1px solid color-mix(in srgb, var(--color-border) 50%, transparent);
  color: var(--color-fg);
}

.section-group .item {
  border-bottom: 1px solid color-mix(in srgb, var(--color-border) 30%, transparent);
}

.section-group .item:last-child {
  border-bottom: none;
}

.code-output {
  padding: 1.5rem;
  border-radius: var(--radius-md);
  font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, monospace;
  font-size: 0.875rem;
  overflow-x: auto;
  white-space: pre;
  margin-top: 1rem;
}

.alert {
  padding: 1rem;
  border-radius: var(--radius-md);
  margin-bottom: 1rem;
}

.hero-actions-box {
  margin-top: 1rem;
  padding: 1rem;
  border-radius: var(--radius-sm);
}

.hero-actions-box h4 {
  margin: 0 0 1rem 0;
  font-size: 0.875rem;
  font-weight: 600;
}

.ml-1 { margin-left: 1rem; }
.mt-1 { margin-top: 1rem; }
.hidden { display: none; }

/* ==========================================================================
   END OF BASE STRUCTURE FILE
   
   This file contains ZERO color definitions, ZERO shadow values, ZERO gradients.
   All visual styling comes from theme files loaded AFTER this file.
   ========================================================================== */