/*
 * TRIO WFS Design System — Shell Stylesheet
 * design-system-shell.css
 *
 * Single source of truth for all page chrome:
 * layout, sidebar, navigation, page header, section cards,
 * grid utilities, property tables, and design tokens.
 *
 * Component-specific styles live in each page's own <style> block.
 * Anatomy / diagram styles live in their own <style> blocks.
 *
 * Link this before any local <style> block:
 *   Root pages:      href="design-system-shell.css"
 *   Component pages: href="../../design-system-shell.css"
 */

/* ============================================================
   DESIGN TOKENS
   ============================================================ */
:root {
  /* Primary */
  --color-primary-main:        #2196F3;
  --color-primary-dark:        #1976D2;
  --color-primary-light:       #E3F2FD;

  /* Secondary / Neutrals */
  --color-secondary-main:      #F5F5F5;
  --color-secondary-dark:      #616161;
  --color-secondary-outline:   #E0E0E0;

  /* Semantic */
  --color-success-main:        #388E3C;
  --color-success-light:       #E8F5E9;
  --color-success-dark:        #2e7d32;
  --color-error-main:          #DB4537;
  --color-error-light:         #FBEAED;
  --color-error-dark:          #BB3430;
  --color-warning-main:        #E17109;
  --color-warning-light:       #FCF1E0;
  --color-warning-dark:        #DA6207;
  --color-info-main:           #54afca;
  --color-info-light:          #E4F7FD;
  --color-info-dark:           #4B9AB0;

  /* Text */
  --color-text-primary:        #212121;
  --color-text-secondary:      rgba(0, 0, 0, 0.6);
  --color-text-disabled:       rgba(0, 0, 0, 0.4);

  /* Surfaces */
  --color-background-default:  #F5F5F5;
  --color-background-secondary: #FAFAFA;
  --color-background-paper:    #FFFFFF;
  --color-disabled-bg:         rgba(0, 0, 0, 0.12);

  /* Typography */
  --font-family: 'Roboto', sans-serif;

  /* Spacing (8px system, 4px exception for intra-component) */
  --spacing-xs:  4px;
  --spacing-sm:  8px;
  --spacing-mid: 12px;
  --spacing-md:  16px;
  --spacing-lg:  24px;
  --spacing-xl:  32px;
  --spacing-xxl: 40px;

  /* Shape */
  --border-radius: 4px;
}

/* ============================================================
   RESET
   ============================================================ */
* {
  margin: 0;
  padding: 0;
  box-sizing: border-box;
}

/* ============================================================
   BODY / ROOT LAYOUT
   ============================================================ */
body {
  font-family: var(--font-family);
  background-color: var(--color-background-default);
  color: var(--color-text-primary);
  display: flex;
  min-height: 100vh;
}

/* ============================================================
   SIDEBAR
   ============================================================ */
.sidebar {
  width: 280px;
  background: var(--color-background-default);
  border-right: 1px solid var(--color-secondary-outline);
  position: fixed;
  height: 100vh;
  overflow-y: auto;
  z-index: 100;
  display: flex;
  flex-direction: column;
}

.sidebar nav {
  flex: 1;
  overflow-y: auto;
}

.sidebar-footer {
  padding: var(--spacing-md);
  border-top: 1px solid var(--color-secondary-outline);
  flex-shrink: 0;
}

.sidebar-download {
  display: flex;
  align-items: center;
  justify-content: center;
  gap: var(--spacing-sm);
  padding: var(--spacing-sm) var(--spacing-md);
  background: transparent;
  color: var(--color-primary-main);
  border: 1px solid var(--color-primary-main);
  border-radius: 4px;
  text-decoration: none;
  font-family: var(--font-family);
  font-size: 13px;
  font-weight: 500;
  transition: background 0.2s;
}

.sidebar-download:hover {
  background: var(--color-primary-light);
}

.sidebar-download .material-icons-outlined {
  font-size: 16px;
}

.sidebar-header {
  padding: var(--spacing-lg);
  border-bottom: 1px solid var(--color-secondary-outline);
}

.sidebar-brand {
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
}

.sidebar-logo {
  width: 28px;
  height: 29px;
  flex-shrink: 0;
}

.sidebar-brand-text h1 {
  font-size: 18px;
  font-weight: 700;
  letter-spacing: 0.08em;
  margin-bottom: 0;
  line-height: 1.2;
}

.brand-separator {
  font-weight: 300;
  color: var(--color-secondary-outline);
  margin: 0 1px;
}

.brand-ui {
  font-weight: 300;
  letter-spacing: 0.12em;
}

.sidebar-header p,
.sidebar-brand-text p {
  font-size: 11px;
  color: var(--color-text-secondary);
  letter-spacing: 0.06em;
  text-transform: uppercase;
  margin-top: 2px;
}

/* ============================================================
   NAVIGATION
   ============================================================ */
.nav-section {
  padding: var(--spacing-md) 0;
  border-bottom: 1px solid var(--color-secondary-outline);
}

.nav-section-title {
  font-size: 11px;
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 1px;
  color: var(--color-text-secondary);
  padding: 0 var(--spacing-lg);
  margin-bottom: var(--spacing-sm);
}

.nav-item {
  display: flex;
  align-items: center;
  padding: var(--spacing-sm) var(--spacing-lg);
  color: var(--color-text-primary);
  text-decoration: none;
  font-size: 14px;
  transition: background 0.2s;
  cursor: pointer;
}

.nav-item:hover {
  background-color: rgba(0, 0, 0, 0.04);
}

.nav-item.active {
  background-color: var(--color-primary-light);
  color: var(--color-primary-main);
  font-weight: 500;
}

.nav-item .material-icons,
.nav-item .material-icons-outlined {
  font-size: 16px;
  margin-right: var(--spacing-sm);
}

.nav-item-empty {
  padding: var(--spacing-sm) var(--spacing-lg);
  font-size: 13px;
  color: var(--color-text-disabled);
  font-style: italic;
}

/* ============================================================
   MAIN CONTENT AREA
   ============================================================ */
.main-content {
  margin-left: 280px;
  flex: 1;
  padding: var(--spacing-xxl);
}

.main-content > *:not(.hero):not(.content-wrap) {
  max-width: 1100px;
  margin-left: auto;
  margin-right: auto;
}

/* ============================================================
   PAGE HEADER
   ============================================================ */
.page-header {
  margin-bottom: var(--spacing-xxl);
}

.page-title {
  font-size: 32px;
  font-weight: 400;
  margin-bottom: var(--spacing-sm);
}

.page-subtitle {
  font-size: 14px;
  color: var(--color-text-secondary);
  line-height: 1.6;
  max-width: 800px;
}

.component-meta {
  display: flex;
  gap: var(--spacing-lg);
  margin-top: var(--spacing-md);
  font-size: 12px;
  color: var(--color-text-secondary);
}

.component-meta span {
  display: flex;
  align-items: center;
  gap: 4px;
}

.meta-link {
  display: flex;
  align-items: center;
  gap: 4px;
  color: var(--color-primary-main);
  text-decoration: none;
  font-size: 12px;
}

.meta-link:hover {
  text-decoration: underline;
}

/* ============================================================
   SECTION CARDS
   ============================================================ */
.section {
  background: var(--color-background-paper);
  border-radius: var(--border-radius);
  padding: var(--spacing-xl);
  margin-bottom: var(--spacing-lg);
}

.section-title {
  font-size: 20px;
  font-weight: 500;
  margin-bottom: var(--spacing-md);
  display: flex;
  align-items: center;
  gap: var(--spacing-sm);
}

.section-title .material-icons {
  font-size: 24px;
  color: var(--color-primary-main);
}

.section-description {
  font-size: 14px;
  color: var(--color-text-secondary);
  line-height: 1.6;
  margin-bottom: var(--spacing-lg);
}

/* ============================================================
   GRID UTILITIES
   ============================================================ */
.grid-2 {
  display: grid;
  grid-template-columns: repeat(2, 1fr);
  gap: var(--spacing-lg);
}

.grid-3 {
  display: grid;
  grid-template-columns: repeat(3, 1fr);
  gap: var(--spacing-lg);
}

.grid-4 {
  display: grid;
  grid-template-columns: repeat(4, 1fr);
  gap: var(--spacing-lg);
}

/* ============================================================
   CARDS
   ============================================================ */
.card {
  background: var(--color-background-default);
  border: 1px solid var(--color-secondary-outline);
  border-radius: var(--border-radius);
  padding: var(--spacing-lg);
}

.card-title {
  font-size: 14px;
  font-weight: 500;
  margin-bottom: var(--spacing-sm);
  display: flex;
  align-items: center;
  gap: var(--spacing-xs);
}

.card-title .material-icons {
  font-size: 18px;
}

.card-content {
  font-size: 13px;
  color: var(--color-text-secondary);
  line-height: 1.5;
}

.card-content ul {
  list-style: none;
  padding: 0;
}

.card-content li {
  padding: 4px 0;
  display: flex;
  align-items: flex-start;
  gap: var(--spacing-xs);
}

.card-content li::before {
  content: "•";
  color: var(--color-primary-main);
  font-weight: bold;
}

/* Do / Don't variants */
.do-card {
  border-left: 3px solid var(--color-success-main);
}

.do-card .card-title {
  color: var(--color-success-main);
}

.dont-card {
  border-left: 3px solid var(--color-error-main);
}

.dont-card .card-title {
  color: var(--color-error-main);
}

/* ============================================================
   VARIANT SHOWCASE HELPERS
   ============================================================ */
.variant-group {
  margin-bottom: var(--spacing-xl);
}

.variant-label {
  font-size: 12px;
  font-weight: 500;
  color: var(--color-text-secondary);
  text-transform: uppercase;
  letter-spacing: 0.5px;
  margin-bottom: var(--spacing-md);
}

/* ============================================================
   PROPERTY / API TABLES
   ============================================================ */
.property-table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13px;
}

.property-table th {
  text-align: left;
  padding: var(--spacing-sm) var(--spacing-md);
  background: var(--color-background-default);
  font-weight: 500;
  color: var(--color-text-secondary);
  border-bottom: 2px solid var(--color-secondary-outline);
}

.property-table td {
  padding: var(--spacing-sm) var(--spacing-md);
  border-bottom: 1px solid var(--color-secondary-outline);
}

.property-table code {
  background: var(--color-background-default);
  padding: 2px 6px;
  border-radius: 3px;
  font-size: 12px;
  font-family: 'Courier New', monospace;
}

/* ============================================================
   TOKEN PATH CHIP
   ============================================================ */
.token-path {
  font-family: 'Courier New', monospace;
  font-size: 11px;
  color: var(--color-primary-main);
  background: var(--color-primary-light);
  padding: 1px 6px;
  border-radius: 3px;
  display: inline-block;
}

/* ============================================================
   WARNING / CALLOUT BOX
   ============================================================ */
.warning-box {
  background: #FCF1E0;
  border-left: 4px solid var(--color-warning-main);
  padding: var(--spacing-md);
  margin: var(--spacing-lg) 0;
  border-radius: var(--border-radius);
  font-size: 14px;
  line-height: 1.6;
}

.warning-box strong {
  color: #DA6207;
}