/* ==========================================================================
   1Engage Multitenant Backend - Codebase Guide Styles
   ========================================================================== */

/* --------------------------------------------------------------------------
   CSS Custom Properties (Light Theme - Default)
   -------------------------------------------------------------------------- */
:root {
  /* Colors */
  --color-bg:              #ffffff;
  --color-bg-secondary:    #f8f9fa;
  --color-bg-tertiary:     #e9ecef;
  --color-surface:         #ffffff;
  --color-border:          #dee2e6;
  --color-border-light:    #e9ecef;

  --color-text:            #212529;
  --color-text-secondary:  #495057;
  --color-text-muted:      #6c757d;
  --color-text-inverse:    #ffffff;

  --color-primary:         #2563eb;
  --color-primary-hover:   #1d4ed8;
  --color-primary-light:   #dbeafe;
  --color-primary-bg:      #eff6ff;

  --color-accent:          #7c3aed;
  --color-success:         #059669;
  --color-warning:         #d97706;
  --color-danger:          #dc2626;

  /* Callout boxes */
  --what-bg:               #eff6ff;
  --what-border:           #2563eb;
  --what-text:             #1e40af;
  --why-bg:                #f0fdf4;
  --why-border:            #16a34a;
  --why-text:              #166534;
  --how-bg:                #fefce8;
  --how-border:            #ca8a04;
  --how-text:              #854d0e;

  /* Code */
  --code-bg:               #1e1e2e;
  --code-text:             #cdd6f4;
  --code-border:           #313244;
  --code-inline-bg:        #f1f3f5;
  --code-inline-text:      #c7254e;

  /* Sidebar */
  --sidebar-bg:            #f8f9fa;
  --sidebar-border:        #e9ecef;
  --sidebar-hover:         #e9ecef;
  --sidebar-active-bg:     #dbeafe;
  --sidebar-active-text:   #2563eb;

  /* Shadows */
  --shadow-sm:             0 1px 2px rgba(0, 0, 0, 0.05);
  --shadow-md:             0 4px 6px -1px rgba(0, 0, 0, 0.1), 0 2px 4px -2px rgba(0, 0, 0, 0.1);
  --shadow-lg:             0 10px 15px -3px rgba(0, 0, 0, 0.1), 0 4px 6px -4px rgba(0, 0, 0, 0.1);

  /* Spacing & Layout */
  --sidebar-width:         280px;
  --content-max-width:     900px;
  --radius-sm:             4px;
  --radius-md:             8px;
  --radius-lg:             12px;

  /* Typography */
  --font-sans:             "Inter", -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Oxygen, Ubuntu, sans-serif;
  --font-mono:             "JetBrains Mono", "Fira Code", "SF Mono", Consolas, "Liberation Mono", monospace;
  --font-size-base:        16px;
  --line-height-base:      1.7;
}

/* --------------------------------------------------------------------------
   Dark Theme
   -------------------------------------------------------------------------- */
[data-theme="dark"] {
  --color-bg:              #0f1117;
  --color-bg-secondary:    #161822;
  --color-bg-tertiary:     #1e2030;
  --color-surface:         #181a25;
  --color-border:          #2a2d3e;
  --color-border-light:    #232536;

  --color-text:            #cdd6f4;
  --color-text-secondary:  #a6adc8;
  --color-text-muted:      #7f849c;
  --color-text-inverse:    #0f1117;

  --color-primary:         #89b4fa;
  --color-primary-hover:   #74c7ec;
  --color-primary-light:   #1e2640;
  --color-primary-bg:      #141b2d;

  --color-accent:          #cba6f7;
  --color-success:         #a6e3a1;
  --color-warning:         #f9e2af;
  --color-danger:          #f38ba8;

  --what-bg:               #141b2d;
  --what-border:           #89b4fa;
  --what-text:             #89b4fa;
  --why-bg:                #142117;
  --why-border:            #a6e3a1;
  --why-text:              #a6e3a1;
  --how-bg:                #211f14;
  --how-border:            #f9e2af;
  --how-text:              #f9e2af;

  --code-bg:               #11111b;
  --code-text:             #cdd6f4;
  --code-border:           #2a2d3e;
  --code-inline-bg:        #1e2030;
  --code-inline-text:      #f38ba8;

  --sidebar-bg:            #11111b;
  --sidebar-border:        #2a2d3e;
  --sidebar-hover:         #1e2030;
  --sidebar-active-bg:     #1e2640;
  --sidebar-active-text:   #89b4fa;

  --shadow-sm:             0 1px 2px rgba(0, 0, 0, 0.3);
  --shadow-md:             0 4px 6px -1px rgba(0, 0, 0, 0.4), 0 2px 4px -2px rgba(0, 0, 0, 0.3);
  --shadow-lg:             0 10px 15px -3px rgba(0, 0, 0, 0.4), 0 4px 6px -4px rgba(0, 0, 0, 0.3);
}

/* --------------------------------------------------------------------------
   Reset & Base
   -------------------------------------------------------------------------- */
*,
*::before,
*::after {
  box-sizing: border-box;
  margin: 0;
  padding: 0;
}

html {
  scroll-behavior: smooth;
  font-size: var(--font-size-base);
  -webkit-text-size-adjust: 100%;
  overflow-x: hidden;
}

body {
  font-family: var(--font-sans);
  font-size: 1rem;
  line-height: var(--line-height-base);
  color: var(--color-text);
  background-color: var(--color-bg);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  overflow-x: hidden;
}

/* --------------------------------------------------------------------------
   Layout
   -------------------------------------------------------------------------- */
.page-wrapper {
  display: flex;
  min-height: 100vh;
}

/* Sidebar */
.sidebar {
  position: fixed;
  top: 0;
  left: 0;
  width: var(--sidebar-width);
  height: 100vh;
  overflow-y: auto;
  background-color: var(--sidebar-bg);
  border-right: 1px solid var(--sidebar-border);
  padding: 1.5rem 0;
  z-index: 100;
  transition: transform 0.3s ease;
}

.sidebar-header {
  padding: 0 1.25rem 1.25rem;
  border-bottom: 1px solid var(--sidebar-border);
  margin-bottom: 1rem;
}

.sidebar-header h2 {
  font-size: 0.875rem;
  font-weight: 700;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--color-primary);
  margin-bottom: 0.25rem;
}

.sidebar-header .subtitle {
  font-size: 0.75rem;
  color: var(--color-text-muted);
}

/* Navigation */
.nav-section {
  padding: 0.75rem 1.25rem 0.5rem;
  font-size: 0.7rem;
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--color-text-muted);
}

.nav-item {
  display: block;
  padding: 0.45rem 1.25rem 0.45rem 1.5rem;
  font-size: 0.875rem;
  color: var(--color-text-secondary);
  text-decoration: none;
  border-left: 3px solid transparent;
  transition: all 0.15s ease;
  line-height: 1.4;
}

.nav-item:hover {
  background-color: var(--sidebar-hover);
  color: var(--color-text);
}

.nav-item.active {
  background-color: var(--sidebar-active-bg);
  color: var(--sidebar-active-text);
  border-left-color: var(--sidebar-active-text);
  font-weight: 600;
}

/* Main content */
.main-content {
  margin-left: var(--sidebar-width);
  flex: 1;
  min-width: 0;
}

.content-wrapper {
  max-width: var(--content-max-width);
  margin: 0 auto;
  padding: 2.5rem 3rem 4rem;
}

/* --------------------------------------------------------------------------
   Header Bar
   -------------------------------------------------------------------------- */
.top-bar {
  position: sticky;
  top: 0;
  z-index: 50;
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0.75rem 2rem;
  background-color: var(--color-bg);
  border-bottom: 1px solid var(--color-border-light);
  backdrop-filter: blur(8px);
  margin-left: var(--sidebar-width);
}

.top-bar-title {
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--color-text-muted);
}

.theme-toggle {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.4rem 0.75rem;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  background: var(--color-bg-secondary);
  color: var(--color-text-secondary);
  font-size: 0.8rem;
  font-family: var(--font-sans);
  cursor: pointer;
  transition: all 0.15s ease;
}

.theme-toggle:hover {
  background: var(--color-bg-tertiary);
  color: var(--color-text);
}

.mobile-menu-btn {
  display: none;
  padding: 0.4rem;
  border: none;
  background: transparent;
  color: var(--color-text);
  font-size: 1.5rem;
  cursor: pointer;
}

/* --------------------------------------------------------------------------
   Typography
   -------------------------------------------------------------------------- */
h1, h2, h3, h4, h5, h6 {
  color: var(--color-text);
  font-weight: 700;
  line-height: 1.3;
  margin-top: 2rem;
  margin-bottom: 0.75rem;
}

h1 {
  font-size: 2rem;
  margin-top: 0;
  padding-bottom: 0.75rem;
  border-bottom: 2px solid var(--color-border-light);
}

h1 .version {
  font-size: 0.875rem;
  font-weight: 400;
  color: var(--color-text-muted);
  margin-left: 0.5rem;
}

h2 {
  font-size: 1.5rem;
  margin-top: 2.5rem;
  padding-bottom: 0.5rem;
  border-bottom: 1px solid var(--color-border-light);
}

h3 { font-size: 1.25rem; }
h4 { font-size: 1.1rem; }
h5 { font-size: 1rem; }
h6 { font-size: 0.875rem; }

p {
  margin-bottom: 1rem;
}

a {
  color: var(--color-primary);
  text-decoration: none;
  transition: color 0.15s ease;
}

a:hover {
  color: var(--color-primary-hover);
  text-decoration: underline;
}

strong {
  font-weight: 600;
}

hr {
  border: none;
  border-top: 1px solid var(--color-border-light);
  margin: 2rem 0;
}

blockquote {
  border-left: 4px solid var(--color-primary);
  padding: 0.75rem 1rem;
  margin: 1rem 0;
  background-color: var(--color-primary-bg);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
  color: var(--color-text-secondary);
}

blockquote p:last-child {
  margin-bottom: 0;
}

/* --------------------------------------------------------------------------
   Lists
   -------------------------------------------------------------------------- */
ul, ol {
  margin-bottom: 1rem;
  padding-left: 1.5rem;
}

li {
  margin-bottom: 0.35rem;
}

li > ul,
li > ol {
  margin-top: 0.35rem;
  margin-bottom: 0;
}

/* --------------------------------------------------------------------------
   Code
   -------------------------------------------------------------------------- */
code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  background-color: var(--code-inline-bg);
  color: var(--code-inline-text);
  padding: 0.15em 0.4em;
  border-radius: var(--radius-sm);
}

pre {
  background-color: var(--code-bg);
  color: var(--code-text);
  border: 1px solid var(--code-border);
  border-radius: var(--radius-md);
  padding: 1.25rem 1.5rem;
  overflow-x: auto;
  margin: 1rem 0 1.5rem;
  line-height: 1.5;
  font-size: 0.875rem;
  position: relative;
}

pre code {
  background: none;
  color: inherit;
  padding: 0;
  font-size: inherit;
  border-radius: 0;
}

/* Code block language label */
pre::before {
  content: attr(data-lang);
  position: absolute;
  top: 0;
  right: 0;
  padding: 0.2rem 0.6rem;
  font-size: 0.7rem;
  font-family: var(--font-sans);
  color: var(--color-text-muted);
  background: var(--code-border);
  border-radius: 0 var(--radius-md) 0 var(--radius-sm);
  text-transform: uppercase;
  letter-spacing: 0.05em;
}

/* Syntax-like coloring within code blocks */
pre .keyword    { color: #c678dd; }
pre .string     { color: #98c379; }
pre .comment    { color: #5c6370; font-style: italic; }
pre .function   { color: #61afef; }
pre .type       { color: #e5c07b; }
pre .number     { color: #d19a66; }
pre .operator   { color: #56b6c2; }
pre .builtin    { color: #e06c75; }

/* --------------------------------------------------------------------------
   Tables
   -------------------------------------------------------------------------- */
table {
  width: 100%;
  border-collapse: collapse;
  margin: 1rem 0 1.5rem;
  font-size: 0.9rem;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  overflow: hidden;
}

thead {
  background-color: var(--color-bg-secondary);
}

th {
  padding: 0.75rem 1rem;
  text-align: left;
  font-weight: 600;
  color: var(--color-text);
  border-bottom: 2px solid var(--color-border);
  font-size: 0.8rem;
  text-transform: uppercase;
  letter-spacing: 0.03em;
}

td {
  padding: 0.65rem 1rem;
  border-bottom: 1px solid var(--color-border-light);
  color: var(--color-text-secondary);
}

/* Alternating row colors */
tbody tr:nth-child(even) {
  background-color: var(--color-bg-secondary);
}

tbody tr:hover {
  background-color: var(--color-primary-bg);
}

/* --------------------------------------------------------------------------
   Callout Boxes
   -------------------------------------------------------------------------- */
.what-box,
.why-box,
.how-box {
  border-radius: var(--radius-md);
  padding: 1rem 1.25rem;
  margin: 1rem 0 1.5rem;
  border-left: 4px solid;
  font-size: 0.925rem;
}

.what-box::before,
.why-box::before,
.how-box::before {
  display: block;
  font-weight: 700;
  font-size: 0.8rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  margin-bottom: 0.4rem;
}

.what-box {
  background-color: var(--what-bg);
  border-color: var(--what-border);
  color: var(--what-text);
}

.what-box::before {
  content: "What";
  color: var(--what-border);
}

.why-box {
  background-color: var(--why-bg);
  border-color: var(--why-border);
  color: var(--why-text);
}

.why-box::before {
  content: "Why";
  color: var(--why-border);
}

.how-box {
  background-color: var(--how-bg);
  border-color: var(--how-border);
  color: var(--how-text);
}

.how-box::before {
  content: "How";
  color: var(--how-border);
}

.what-box p:last-child,
.why-box p:last-child,
.how-box p:last-child {
  margin-bottom: 0;
}

/* Callout variants */
.callout {
  background-color: var(--color-primary-bg);
  border-left: 4px solid var(--color-primary);
  border-radius: 0 var(--radius-md) var(--radius-md) 0;
  padding: 1rem 1.25rem;
  margin: 1rem 0 1.5rem;
  font-size: 0.925rem;
}

.callout strong {
  color: var(--color-text);
}

.callout-info {
  background-color: var(--what-bg);
  border-left-color: var(--what-border);
  color: var(--what-text);
}

.callout-warning,
.callout-warn {
  background-color: var(--how-bg);
  border-left-color: var(--how-border);
  color: var(--how-text);
}

.callout-success {
  background-color: var(--why-bg);
  border-left-color: var(--why-border);
  color: var(--why-text);
}

.callout p:last-child {
  margin-bottom: 0;
}

/* Pattern tags */
.pattern-tag {
  display: inline-block;
  padding: 2px 8px;
  font-size: 0.7rem;
  font-weight: 600;
  border-radius: 4px;
  background: var(--color-bg-tertiary);
  color: var(--color-text-muted);
  margin-right: 4px;
  vertical-align: middle;
  font-family: var(--font-mono);
}

.pattern-tag.mutex { background: #ede0ff; color: #6741d9; }
.pattern-tag.channel { background: #d3f9d8; color: #2b8a3e; }
.pattern-tag.goroutine { background: #fff3bf; color: #e67700; }
.pattern-tag.select { background: #ffd8d8; color: #c92a2a; }
.pattern-tag.waitgroup { background: #d0ebff; color: #1864ab; }
.pattern-tag.generics { background: #dbeafe; color: #1e40af; }
.pattern-tag.embedding { background: #fce7f3; color: #9d174d; }
.pattern-tag.reflect { background: #fef3c7; color: #92400e; }
.pattern-tag.defer { background: #d1fae5; color: #065f46; }
.pattern-tag.closure { background: #ede9fe; color: #5b21b6; }
.pattern-tag.typeassert { background: #fee2e2; color: #991b1b; }
.pattern-tag.receiver { background: #e0f2fe; color: #075985; }
.pattern-tag.functype { background: #fef9c3; color: #854d0e; }
.pattern-tag.init { background: #f3e8ff; color: #6b21a8; }
.pattern-tag.ldflags { background: #ecfdf5; color: #047857; }
.pattern-tag.arch { background: #dbeafe; color: #1e40af; }
.pattern-tag.gateway { background: #fce7f3; color: #9d174d; }
.pattern-tag.tenant { background: #d1fae5; color: #065f46; }
.pattern-tag.config { background: #fef3c7; color: #92400e; }
.pattern-tag.db { background: #ede9fe; color: #5b21b6; }
.pattern-tag.comms { background: #fee2e2; color: #991b1b; }
.pattern-tag.shutdown { background: #e0f2fe; color: #075985; }
.pattern-tag.otel { background: #fef9c3; color: #854d0e; }
.pattern-tag.mw { background: #f3e8ff; color: #6b21a8; }
.pattern-tag.api { background: #ecfdf5; color: #047857; }

[data-theme="dark"] .pattern-tag.mutex { background: #2e1f57; color: #b197fc; }
[data-theme="dark"] .pattern-tag.channel { background: #0f2a14; color: #69db7c; }
[data-theme="dark"] .pattern-tag.goroutine { background: #2a2210; color: #ffd43b; }
[data-theme="dark"] .pattern-tag.select { background: #2a0f0f; color: #ff8787; }
[data-theme="dark"] .pattern-tag.waitgroup { background: #0f1a2e; color: #74c0fc; }
[data-theme="dark"] .pattern-tag.generics { background: #1e2640; color: #93c5fd; }
[data-theme="dark"] .pattern-tag.embedding { background: #3b0a2a; color: #f9a8d4; }
[data-theme="dark"] .pattern-tag.reflect { background: #362a0a; color: #fcd34d; }
[data-theme="dark"] .pattern-tag.defer { background: #022c22; color: #6ee7b7; }
[data-theme="dark"] .pattern-tag.closure { background: #2e1065; color: #c4b5fd; }
[data-theme="dark"] .pattern-tag.typeassert { background: #450a0a; color: #fca5a5; }
[data-theme="dark"] .pattern-tag.receiver { background: #0c4a6e; color: #7dd3fc; }
[data-theme="dark"] .pattern-tag.functype { background: #422006; color: #fde047; }
[data-theme="dark"] .pattern-tag.init { background: #3b0764; color: #d8b4fe; }
[data-theme="dark"] .pattern-tag.ldflags { background: #022c22; color: #6ee7b7; }
[data-theme="dark"] .pattern-tag.arch { background: #1e2640; color: #93c5fd; }
[data-theme="dark"] .pattern-tag.gateway { background: #3b0a2a; color: #f9a8d4; }
[data-theme="dark"] .pattern-tag.tenant { background: #022c22; color: #6ee7b7; }
[data-theme="dark"] .pattern-tag.config { background: #362a0a; color: #fcd34d; }
[data-theme="dark"] .pattern-tag.db { background: #2e1065; color: #c4b5fd; }
[data-theme="dark"] .pattern-tag.comms { background: #450a0a; color: #fca5a5; }
[data-theme="dark"] .pattern-tag.shutdown { background: #0c4a6e; color: #7dd3fc; }
[data-theme="dark"] .pattern-tag.otel { background: #422006; color: #fde047; }
[data-theme="dark"] .pattern-tag.mw { background: #3b0764; color: #d8b4fe; }
[data-theme="dark"] .pattern-tag.api { background: #022c22; color: #6ee7b7; }

/* Section number styling */
.sec-num {
  color: var(--color-primary);
  margin-right: 6px;
}

/* --------------------------------------------------------------------------
   File Reference Pill
   -------------------------------------------------------------------------- */
.file-ref {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.8em;
  background-color: var(--color-bg-tertiary);
  color: var(--color-text-muted);
  padding: 0.1em 0.55em;
  border-radius: 999px;
  border: 1px solid var(--color-border-light);
  white-space: nowrap;
  text-decoration: none;
  transition: all 0.15s ease;
}

.file-ref:hover {
  background-color: var(--color-primary-light);
  color: var(--color-primary);
  border-color: var(--color-primary);
  text-decoration: none;
}

/* --------------------------------------------------------------------------
   Diagram (ASCII art)
   -------------------------------------------------------------------------- */
.diagram {
  display: block;
  text-align: center;
  margin: 1.5rem auto;
  padding: 1.5rem;
  background-color: var(--color-bg-secondary);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  overflow-x: auto;
}

.diagram pre {
  display: inline-block;
  text-align: left;
  margin: 0;
  padding: 0;
  background: transparent;
  border: none;
  color: var(--color-text);
  font-size: 0.8rem;
  line-height: 1.4;
}

.diagram pre::before {
  content: none;
}

/* Diagram boxes and arrows (for flow diagrams) */
.diagram .box {
  display: inline-block;
  padding: 6px 14px;
  background: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: 6px;
  white-space: nowrap;
  font-family: var(--font-mono);
  font-size: 0.78rem;
  margin: 2px;
}

.diagram .arrow {
  font-size: 1.1rem;
  color: var(--color-text-muted);
  margin: 0 4px;
}

/* --------------------------------------------------------------------------
   Badge
   -------------------------------------------------------------------------- */
.badge {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.7rem;
  font-weight: 600;
  padding: 0.15em 0.5em;
  border-radius: var(--radius-sm);
  background-color: var(--color-primary-light);
  color: var(--color-primary);
  white-space: nowrap;
  vertical-align: middle;
}

.badge.port {
  background-color: var(--color-primary-light);
  color: var(--color-primary);
}

.badge.go {
  background-color: #e0f2fe;
  color: #0369a1;
}

[data-theme="dark"] .badge.go {
  background-color: #0c2d48;
  color: #7dd3fc;
}

.badge.db {
  background-color: #fce7f3;
  color: #be185d;
}

[data-theme="dark"] .badge.db {
  background-color: #3b0a2a;
  color: #f9a8d4;
}

.badge.kafka {
  background-color: #fef3c7;
  color: #92400e;
}

[data-theme="dark"] .badge.kafka {
  background-color: #362a0a;
  color: #fcd34d;
}

/* --------------------------------------------------------------------------
   Cards (for page links)
   -------------------------------------------------------------------------- */
.card-grid {
  display: grid;
  grid-template-columns: repeat(auto-fill, minmax(380px, 1fr));
  gap: 1rem;
  margin: 1.5rem 0;
}

.card {
  display: block;
  padding: 1.25rem 1.5rem;
  background-color: var(--color-surface);
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  text-decoration: none;
  transition: all 0.2s ease;
  box-shadow: var(--shadow-sm);
}

.card:hover {
  border-color: var(--color-primary);
  box-shadow: var(--shadow-md);
  transform: translateY(-2px);
  text-decoration: none;
}

.card-number {
  display: inline-block;
  font-family: var(--font-mono);
  font-size: 0.7rem;
  font-weight: 700;
  color: var(--color-primary);
  background-color: var(--color-primary-light);
  padding: 0.15rem 0.5rem;
  border-radius: var(--radius-sm);
  margin-bottom: 0.5rem;
}

.card-title {
  font-size: 1.05rem;
  font-weight: 700;
  color: var(--color-text);
  margin-bottom: 0.35rem;
}

.card-desc {
  font-size: 0.85rem;
  color: var(--color-text-muted);
  line-height: 1.5;
}

/* --------------------------------------------------------------------------
   Collapsible Details / Summary
   -------------------------------------------------------------------------- */
details {
  margin: 1rem 0;
  border: 1px solid var(--color-border);
  border-radius: var(--radius-md);
  overflow: hidden;
}

details[open] {
  box-shadow: var(--shadow-sm);
}

summary {
  padding: 0.75rem 1rem;
  font-weight: 600;
  cursor: pointer;
  background-color: var(--color-bg-secondary);
  color: var(--color-text);
  user-select: none;
  list-style: none;
  display: flex;
  align-items: center;
  gap: 0.5rem;
  transition: background-color 0.15s ease;
}

summary:hover {
  background-color: var(--color-bg-tertiary);
}

summary::-webkit-details-marker {
  display: none;
}

summary::before {
  content: "\25B6";
  font-size: 0.65rem;
  transition: transform 0.2s ease;
  color: var(--color-text-muted);
}

details[open] > summary::before {
  transform: rotate(90deg);
}

details > :not(summary) {
  padding: 0 1rem;
}

details > p:first-of-type {
  margin-top: 1rem;
}

details > :last-child {
  margin-bottom: 1rem;
}

/* --------------------------------------------------------------------------
   Intro / Hero
   -------------------------------------------------------------------------- */
.intro {
  font-size: 1.1rem;
  color: var(--color-text-secondary);
  margin-bottom: 2rem;
  line-height: 1.8;
}

.intro strong {
  color: var(--color-text);
}

/* --------------------------------------------------------------------------
   Section anchor links
   -------------------------------------------------------------------------- */
h2[id],
h3[id] {
  scroll-margin-top: 4rem;
}

h2[id]:hover .anchor,
h3[id]:hover .anchor {
  opacity: 1;
}

.anchor {
  opacity: 0;
  margin-left: 0.35rem;
  color: var(--color-text-muted);
  font-weight: 400;
  transition: opacity 0.15s ease;
  text-decoration: none;
}

.anchor:hover {
  color: var(--color-primary);
  text-decoration: none;
}

/* --------------------------------------------------------------------------
   Responsive Design
   -------------------------------------------------------------------------- */
@media (max-width: 1024px) {
  .content-wrapper {
    padding: 2rem 2rem 3rem;
  }
}

@media (max-width: 768px) {
  /* Prevent horizontal overflow */
  html, body {
    overflow-x: hidden;
    width: 100%;
    max-width: 100vw;
  }

  .sidebar {
    transform: translateX(-100%);
    box-shadow: var(--shadow-lg);
  }

  .sidebar.open {
    transform: translateX(0);
  }

  .sidebar-overlay {
    display: none;
    position: fixed;
    inset: 0;
    background: rgba(0, 0, 0, 0.5);
    z-index: 99;
  }

  .sidebar-overlay.active {
    display: block;
  }

  .main-content {
    margin-left: 0;
    width: 100%;
    max-width: 100vw;
    overflow-x: hidden;
  }

  .top-bar {
    margin-left: 0;
    width: 100%;
  }

  .mobile-menu-btn {
    display: block;
  }

  .content-wrapper {
    padding: 1.5rem 1rem 3rem;
    width: 100%;
    max-width: 100%;
    overflow-x: hidden;
  }

  h1 { font-size: 1.5rem; }
  h2 { font-size: 1.25rem; }
  h3 { font-size: 1.1rem; }

  .card-grid {
    grid-template-columns: 1fr;
  }

  /* Tables: horizontal scroll on mobile */
  table {
    font-size: 0.8rem;
    display: block;
    overflow-x: auto;
    max-width: 100%;
    -webkit-overflow-scrolling: touch;
  }

  th, td {
    padding: 0.5rem 0.6rem;
    white-space: nowrap;
  }

  /* Code blocks: horizontal scroll */
  pre {
    font-size: 0.8rem;
    padding: 1rem;
    max-width: 100%;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }

  pre code {
    word-wrap: normal;
    white-space: pre;
  }

  /* Diagrams: horizontal scroll */
  .diagram {
    max-width: 100%;
    overflow-x: auto;
    -webkit-overflow-scrolling: touch;
  }

  /* Ensure all direct children of content-wrapper don't overflow */
  .content-wrapper > * {
    max-width: 100%;
  }

  /* File refs: allow wrapping */
  .file-ref {
    white-space: normal;
    word-break: break-all;
  }

  /* Pattern tags: allow wrapping */
  .pattern-tag {
    margin-bottom: 4px;
  }

  /* Sidebar: momentum scrolling */
  .sidebar {
    -webkit-overflow-scrolling: touch;
    overscroll-behavior: contain;
  }
}

@media (max-width: 480px) {
  .content-wrapper {
    padding: 1rem 0.75rem 2rem;
    padding-left: max(0.75rem, env(safe-area-inset-left));
    padding-right: max(0.75rem, env(safe-area-inset-right));
    padding-bottom: max(2rem, env(safe-area-inset-bottom));
  }

  .what-box,
  .why-box,
  .how-box {
    padding: 0.75rem 1rem;
  }

  /* Smaller typography for very small screens */
  h1 { font-size: 1.35rem; }
  h2 { font-size: 1.15rem; }
  h3 { font-size: 1rem; }

  /* Even smaller code blocks */
  pre {
    font-size: 0.75rem;
    padding: 0.75rem;
  }

  /* Top bar safe area */
  .top-bar {
    padding-top: max(0.75rem, env(safe-area-inset-top));
    padding-left: max(0.75rem, env(safe-area-inset-left));
    padding-right: max(0.75rem, env(safe-area-inset-right));
  }

  /* Sidebar safe area */
  .sidebar {
    padding-top: max(1.5rem, env(safe-area-inset-top));
    padding-bottom: max(1rem, env(safe-area-inset-bottom));
  }
}

/* --------------------------------------------------------------------------
   Print Styles
   -------------------------------------------------------------------------- */
@media print {
  .sidebar,
  .top-bar,
  .theme-toggle,
  .mobile-menu-btn,
  .sidebar-overlay {
    display: none !important;
  }

  .main-content {
    margin-left: 0 !important;
  }

  .content-wrapper {
    max-width: 100%;
    padding: 0;
  }

  body {
    color: #000;
    background: #fff;
    font-size: 12pt;
    line-height: 1.5;
  }

  a {
    color: #000;
    text-decoration: underline;
  }

  a[href^="http"]::after {
    content: " (" attr(href) ")";
    font-size: 0.8em;
    color: #555;
  }

  pre {
    border: 1px solid #ccc;
    background: #f5f5f5 !important;
    color: #000 !important;
    white-space: pre-wrap;
    word-wrap: break-word;
    page-break-inside: avoid;
  }

  table {
    page-break-inside: avoid;
  }

  .what-box,
  .why-box,
  .how-box {
    border: 1px solid #ccc;
    background: #f9f9f9 !important;
    color: #000 !important;
  }

  h1, h2, h3, h4, h5, h6 {
    page-break-after: avoid;
    color: #000;
  }

  .card {
    border: 1px solid #ccc;
    box-shadow: none;
  }

  .badge {
    border: 1px solid #ccc;
    background: transparent !important;
    color: #000 !important;
  }
}

/* --------------------------------------------------------------------------
   Scrollbar Styling (Webkit)
   -------------------------------------------------------------------------- */
::-webkit-scrollbar {
  width: 8px;
  height: 8px;
}

::-webkit-scrollbar-track {
  background: var(--color-bg-secondary);
}

::-webkit-scrollbar-thumb {
  background: var(--color-border);
  border-radius: 4px;
}

::-webkit-scrollbar-thumb:hover {
  background: var(--color-text-muted);
}

/* --------------------------------------------------------------------------
   Selection
   -------------------------------------------------------------------------- */
::selection {
  background-color: var(--color-primary);
  color: var(--color-text-inverse);
}

/* --------------------------------------------------------------------------
   Utility Classes
   -------------------------------------------------------------------------- */
.mt-0 { margin-top: 0; }
.mb-0 { margin-bottom: 0; }
.mt-1 { margin-top: 0.5rem; }
.mt-2 { margin-top: 1rem; }
.mb-2 { margin-bottom: 1rem; }
.text-muted { color: var(--color-text-muted); }
.text-center { text-align: center; }
.text-small { font-size: 0.85rem; }
.visually-hidden {
  position: absolute;
  width: 1px;
  height: 1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
}