/* ============================================
   Editorial Technical Manual — Design System
   2026 教育信息技术应用创新大赛 · 初赛理论培训
   ============================================ */

/* ============================================
   Fonts
   ============================================ */
@import url('https://fonts.googleapis.com/css2?family=Noto+Serif+SC:wght@400;500;600;700;900&family=JetBrains+Mono:ital,wght@0,400;0,500;0,600;1,400&display=swap');

/* ============================================
   Design Tokens — Light Theme
   ============================================ */
:root {
  /* ----- Ink-green accent ----- */
  --accent-h: 168;
  --accent-s: 0.28;
  --accent-l: 0.38;
  --accent:        oklch(var(--accent-l) var(--accent-s) var(--accent-h));
  --accent-strong: oklch(calc(var(--accent-l) - 0.08) var(--accent-s) var(--accent-h));
  --accent-muted:  oklch(calc(var(--accent-l) + 0.12) calc(var(--accent-s) * 0.5) var(--accent-h));
  --accent-ghost:  oklch(0.92 0.03 var(--accent-h));

  /* ----- Surfaces: warm paper ----- */
  --bg-page:       oklch(0.965 0.006 90);
  --bg-surface:    oklch(0.985 0.003 88);
  --bg-surface-alt:oklch(0.975 0.004 90);
  --bg-elevated:   oklch(0.99 0.002 85);

  /* ----- Text: ink ----- */
  --text-primary:   oklch(0.20 0.012 175);
  --text-secondary: oklch(0.35 0.010 170);
  --text-tertiary:  oklch(0.50 0.008 165);
  --text-on-accent: oklch(0.97 0.003 90);

  /* ----- Borders ----- */
  --border-default: oklch(0.86 0.012 155);
  --border-subtle:  oklch(0.91 0.008 150);

  /* ----- Code ----- */
  --code-bg:        oklch(0.94 0.008 155);
  --code-border:    oklch(0.88 0.012 155);
  --code-text:      oklch(0.22 0.015 170);
  --code-comment:   oklch(0.52 0.010 160);
  --code-keyword:   oklch(0.40 0.14 260);
  --code-string:    oklch(0.42 0.14 25);
  --code-number:    oklch(0.42 0.12 130);

  /* ----- Callouts ----- */
  --info-bg:        oklch(0.93 0.04 220);
  --info-border:    oklch(0.55 0.12 235);
  --info-text:      oklch(0.28 0.05 230);
  --tip-bg:         oklch(0.93 0.04 155);
  --tip-border:     oklch(0.50 0.13 160);
  --tip-text:       oklch(0.28 0.06 155);
  --warn-bg:        oklch(0.93 0.06 70);
  --warn-border:    oklch(0.55 0.15 55);
  --warn-text:      oklch(0.30 0.08 50);

  /* ----- Shadows ----- */
  --shadow-sm:  0 1px 2px oklch(0.15 0.01 170 / 0.06);
  --shadow-md:  0 2px 8px oklch(0.15 0.01 170 / 0.08);
  --shadow-lg:  0 4px 16px oklch(0.15 0.01 170 / 0.10);

  /* ----- Typography scale (clamp min→preferred→max) ----- */
  --text-body:   clamp(0.9375rem, 0.9rem + 0.15vw, 1.0625rem);
  --text-sm:     clamp(0.8125rem, 0.79rem + 0.08vw, 0.875rem);
  --text-xs:     clamp(0.75rem, 0.73rem + 0.06vw, 0.8125rem);
  --text-h1:     clamp(1.75rem, 1.4rem + 1.4vw, 2.625rem);
  --text-h2:     clamp(1.375rem, 1.2rem + 0.7vw, 1.75rem);
  --text-h3:     clamp(1.125rem, 1.05rem + 0.3vw, 1.3125rem);
  --text-h4:     clamp(1rem, 0.95rem + 0.2vw, 1.125rem);
  --text-hero-stat: clamp(1.5rem, 1.3rem + 0.8vw, 2rem);

  /* ----- Spacing ----- */
  --space-section: clamp(2.5rem, 2rem + 2vw, 4rem);
  --space-block:   clamp(1.25rem, 1rem + 1vw, 2rem);
  --space-element: clamp(0.75rem, 0.6rem + 0.5vw, 1.25rem);

  /* ----- Layout ----- */
  --sidebar-width: 280px;
  --content-max:   860px;
  --content-padding-inline: clamp(1rem, 2rem + 2vw, 3.5rem);

  /* ----- Radii ----- */
  --radius-sm: 4px;
  --radius-md: 6px;
  --radius-lg: 10px;

  /* ----- Transitions ----- */
  --ease-out-quart: cubic-bezier(0.25, 1, 0.5, 1);
  --ease-out-expo:  cubic-bezier(0.16, 1, 0.3, 1);
  --duration-fast:  150ms;
  --duration-base:  250ms;
  --duration-slow:  400ms;
}

/* ============================================
   Design Tokens — Dark Theme
   ============================================ */
[data-theme="dark"] {
  --accent-l: 0.58;
  --accent-s: 0.30;
  --accent:        oklch(var(--accent-l) var(--accent-s) var(--accent-h));
  --accent-strong: oklch(calc(var(--accent-l) + 0.10) var(--accent-s) var(--accent-h));
  --accent-muted:  oklch(calc(var(--accent-l) - 0.15) calc(var(--accent-s) * 0.4) var(--accent-h));
  --accent-ghost:  oklch(0.22 0.04 var(--accent-h));

  --bg-page:       oklch(0.16 0.010 170);
  --bg-surface:    oklch(0.19 0.010 168);
  --bg-surface-alt:oklch(0.18 0.008 170);
  --bg-elevated:   oklch(0.21 0.009 168);

  --text-primary:   oklch(0.88 0.005 90);
  --text-secondary: oklch(0.70 0.008 100);
  --text-tertiary:  oklch(0.52 0.007 110);
  --text-on-accent: oklch(0.15 0.01 170);

  --border-default: oklch(0.28 0.012 165);
  --border-subtle:  oklch(0.24 0.010 165);

  --code-bg:        oklch(0.20 0.012 168);
  --code-border:    oklch(0.26 0.012 168);
  --code-text:      oklch(0.82 0.008 100);
  --code-comment:   oklch(0.50 0.010 160);
  --code-keyword:   oklch(0.62 0.14 250);
  --code-string:    oklch(0.60 0.14 35);
  --code-number:    oklch(0.58 0.12 145);

  --info-bg:        oklch(0.18 0.03 225);
  --info-border:    oklch(0.30 0.08 230);
  --info-text:      oklch(0.78 0.04 220);
  --tip-bg:         oklch(0.18 0.03 160);
  --tip-border:     oklch(0.30 0.09 160);
  --tip-text:       oklch(0.78 0.05 155);
  --warn-bg:        oklch(0.18 0.04 65);
  --warn-border:    oklch(0.35 0.12 55);
  --warn-text:      oklch(0.80 0.06 55);

  --shadow-sm:  0 1px 2px oklch(0.05 0.005 170 / 0.25);
  --shadow-md:  0 2px 8px oklch(0.05 0.005 170 / 0.35);
  --shadow-lg:  0 4px 16px oklch(0.05 0.005 170 / 0.45);
}

/* Auto dark mode from system preference */
@media (prefers-color-scheme: dark) {
  :root:not([data-theme="light"]) {
    --accent-l: 0.58;
    --accent-s: 0.30;
    --accent:        oklch(var(--accent-l) var(--accent-s) var(--accent-h));
    --accent-strong: oklch(calc(var(--accent-l) + 0.10) var(--accent-s) var(--accent-h));
    --accent-muted:  oklch(calc(var(--accent-l) - 0.15) calc(var(--accent-s) * 0.4) var(--accent-h));
    --accent-ghost:  oklch(0.22 0.04 var(--accent-h));

    --bg-page:       oklch(0.16 0.010 170);
    --bg-surface:    oklch(0.19 0.010 168);
    --bg-surface-alt:oklch(0.18 0.008 170);
    --bg-elevated:   oklch(0.21 0.009 168);

    --text-primary:   oklch(0.88 0.005 90);
    --text-secondary: oklch(0.70 0.008 100);
    --text-tertiary:  oklch(0.52 0.007 110);
    --text-on-accent: oklch(0.15 0.01 170);

    --border-default: oklch(0.28 0.012 165);
    --border-subtle:  oklch(0.24 0.010 165);

    --code-bg:        oklch(0.20 0.012 168);
    --code-border:    oklch(0.26 0.012 168);
    --code-text:      oklch(0.82 0.008 100);
    --code-comment:   oklch(0.50 0.010 160);
    --code-keyword:   oklch(0.62 0.14 250);
    --code-string:    oklch(0.60 0.14 35);
    --code-number:    oklch(0.58 0.12 145);

    --info-bg:        oklch(0.18 0.03 225);
    --info-border:    oklch(0.30 0.08 230);
    --info-text:      oklch(0.78 0.04 220);
    --tip-bg:         oklch(0.18 0.03 160);
    --tip-border:     oklch(0.30 0.09 160);
    --tip-text:       oklch(0.78 0.05 155);
    --warn-bg:        oklch(0.18 0.04 65);
    --warn-border:    oklch(0.35 0.12 55);
    --warn-text:      oklch(0.80 0.06 55);

    --shadow-sm:  0 1px 2px oklch(0.05 0.005 170 / 0.25);
    --shadow-md:  0 2px 8px oklch(0.05 0.005 170 / 0.35);
    --shadow-lg:  0 4px 16px oklch(0.05 0.005 170 / 0.45);
  }
}

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

html {
  scroll-behavior: smooth;
  scroll-padding-top: 2rem;
  -webkit-text-size-adjust: 100%;
  text-size-adjust: 100%;
}

body {
  font-family: "Noto Serif SC", "Source Han Serif SC", "STSong", "Songti SC", "SimSun", Georgia, "Times New Roman", serif;
  font-size: var(--text-body);
  line-height: 1.8;
  color: var(--text-primary);
  background: var(--bg-page);
  -webkit-font-smoothing: antialiased;
  -moz-osx-font-smoothing: grayscale;
  font-feature-settings: "kern" 1, "liga" 1;
}

img {
  display: block;
  max-width: 100%;
  height: auto;
  border-radius: var(--radius-md);
  box-shadow: var(--shadow-sm);
}

::selection {
  background: var(--accent);
  color: var(--text-on-accent);
}

/* ============================================
   Focus Ring
   ============================================ */
:focus-visible {
  outline: 2px solid var(--accent);
  outline-offset: 2px;
  border-radius: 2px;
}

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

/* ============================================
   Sidebar / Table of Contents
   ============================================ */
.sidebar {
  position: fixed;
  inset-block-start: 0;
  inset-inline-start: 0;
  inset-block-end: 0;
  width: var(--sidebar-width);
  background: var(--bg-surface);
  border-inline-end: 1px solid var(--border-subtle);
  overflow-y: auto;
  z-index: 100;
  padding-block: 1.5rem;
  display: flex;
  flex-direction: column;
  transition: transform var(--duration-base) var(--ease-out-expo);
}

.sidebar-header {
  padding-inline: 1.25rem;
  padding-block-end: 1rem;
  margin-block-end: 0.75rem;
  border-block-end: 1px solid var(--border-subtle);
  flex-shrink: 0;
}

.sidebar-header .doc-label {
  display: block;
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.08em;
  text-transform: uppercase;
  margin-block-end: 0.35rem;
}

.sidebar-header .doc-title {
  font-size: var(--text-sm);
  font-weight: 500;
  color: var(--text-secondary);
  line-height: 1.5;
}

/* ----- Theme toggle inside sidebar ----- */
.theme-toggle {
  display: flex;
  align-items: center;
  gap: 0.5rem;
  padding: 0.5rem 1.25rem;
  margin-block-end: 0.75rem;
  border: none;
  background: none;
  color: var(--text-tertiary);
  font-family: inherit;
  font-size: var(--text-xs);
  cursor: pointer;
  transition: color var(--duration-fast) var(--ease-out-quart);
  flex-shrink: 0;
}

.theme-toggle:hover { color: var(--accent); }
.theme-toggle:active { color: var(--accent-strong); }

.theme-toggle .toggle-icon {
  width: 18px;
  height: 18px;
  flex-shrink: 0;
}

.theme-toggle .toggle-icon svg {
  width: 100%;
  height: 100%;
  stroke: currentColor;
  fill: none;
  stroke-width: 1.8;
  stroke-linecap: round;
  stroke-linejoin: round;
}

/* ----- TOC navigation ----- */
.sidebar-nav {
  padding-inline: 0.75rem;
  flex: 1;
  overflow-y: auto;
}

.toc-group-title {
  font-size: 0.6875rem;
  font-weight: 700;
  color: var(--text-tertiary);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  padding-block: 1rem 0.35rem;
  padding-inline: 0.6rem;
}

.toc-link {
  display: block;
  padding-block: 0.35rem;
  padding-inline: 0.6rem;
  font-size: 0.8125rem;
  color: var(--text-secondary);
  text-decoration: none;
  border-radius: var(--radius-sm);
  transition: background var(--duration-fast) var(--ease-out-quart),
              color var(--duration-fast) var(--ease-out-quart);
  line-height: 1.5;
  position: relative;
}

.toc-link:hover {
  background: var(--accent-ghost);
  color: var(--accent-strong);
}

.toc-link:active {
  background: var(--accent-muted);
  color: var(--accent);
}

.toc-link.active {
  background: var(--accent-ghost);
  color: var(--accent);
  font-weight: 600;
}

.toc-link.active::before {
  content: "";
  position: absolute;
  inset-inline-start: 0;
  inset-block: 0.25rem;
  width: 3px;
  background: var(--accent);
  border-radius: 0 2px 2px 0;
}

.toc-link.toc-sub {
  padding-inline-start: 1.5rem;
  font-size: 0.78125rem;
}

/* ============================================
   Main Content
   ============================================ */
.main-content {
  flex: 1;
  margin-inline-start: var(--sidebar-width);
  min-width: 0;
  padding-block-end: 4rem;
}

.content-inner {
  max-width: var(--content-max);
  margin-inline: auto;
  padding-inline: var(--content-padding-inline);
  padding-block-start: var(--space-section);
}

/* ============================================
   Hero Section
   ============================================ */
.hero {
  margin-block-end: var(--space-section);
  padding-block-end: var(--space-section);
  border-block-end: 1px solid var(--border-subtle);
}

.hero-label {
  display: inline-block;
  font-size: var(--text-xs);
  font-weight: 600;
  color: var(--accent);
  letter-spacing: 0.1em;
  text-transform: uppercase;
  margin-block-end: 1rem;
}

.hero h1 {
  font-family: "Noto Serif SC", "Source Han Serif SC", "STSong", "Songti SC", serif;
  font-size: var(--text-h1);
  font-weight: 900;
  color: var(--text-primary);
  line-height: 1.35;
  letter-spacing: -0.01em;
  margin-block-end: 1rem;
  text-wrap: balance;
}

.hero-subtitle {
  font-size: var(--text-body);
  color: var(--text-secondary);
  line-height: 1.8;
  max-inline-size: 42em;
  margin-block-end: 2rem;
  text-wrap: pretty;
}

.hero-meta {
  display: flex;
  gap: clamp(1.5rem, 2rem + 2vw, 3rem);
  flex-wrap: wrap;
}

.hero-meta-item .num {
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Consolas", monospace;
  font-size: var(--text-hero-stat);
  font-weight: 600;
  color: var(--accent);
  line-height: 1.2;
  font-feature-settings: "tnum" 1;
}

.hero-meta-item .label {
  font-size: var(--text-xs);
  color: var(--text-tertiary);
  margin-block-start: 0.25rem;
  letter-spacing: 0.03em;
}

/* ============================================
   Section Headers
   ============================================ */
.section {
  margin-block-end: var(--space-section);
  padding-block-end: var(--space-section);
  border-block-end: 1px solid var(--border-subtle);
}

.section:last-of-type {
  border-block-end: none;
  padding-block-end: 0;
}

.section-header {
  display: flex;
  align-items: flex-start;
  gap: 1rem;
  margin-block-end: var(--space-block);
}

.section-number {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Consolas", monospace;
  font-size: 0.875rem;
  font-weight: 600;
  color: var(--accent);
  background: var(--accent-ghost);
  min-inline-size: 2.25rem;
  min-block-size: 2.25rem;
  border-radius: var(--radius-sm);
  flex-shrink: 0;
  font-feature-settings: "tnum" 1;
}

.section-header h2 {
  font-family: "Noto Serif SC", "Source Han Serif SC", "STSong", "Songti SC", serif;
  font-size: var(--text-h2);
  font-weight: 700;
  color: var(--text-primary);
  line-height: 1.4;
  letter-spacing: -0.005em;
  padding-block-start: 0.2rem;
}

/* ============================================
   Subsection Headings
   ============================================ */
.subsection {
  margin-block-end: var(--space-block);
}

.subsection:last-child {
  margin-block-end: 0;
}

.subsection h3 {
  font-family: "Noto Serif SC", "Source Han Serif SC", "STSong", "Songti SC", serif;
  font-size: var(--text-h3);
  font-weight: 600;
  color: var(--text-primary);
  line-height: 1.5;
  margin-block-end: var(--space-element);
  padding-inline-start: 0.85rem;
  border-inline-start: 3px solid var(--accent);
}

.subsection h4 {
  font-family: "Noto Serif SC", "Source Han Serif SC", "STSong", "Songti SC", serif;
  font-size: var(--text-h4);
  font-weight: 600;
  color: var(--accent-strong);
  margin-block: var(--space-element) 0.6rem;
  line-height: 1.5;
}

.subsection h5 {
  font-family: "Noto Serif SC", "Source Han Serif SC", "STSong", "Songti SC", serif;
  font-size: var(--text-body);
  font-weight: 600;
  color: var(--text-secondary);
  margin-block: 0.75rem 0.4rem;
  line-height: 1.5;
}

/* ============================================
   Paragraphs & Lists
   ============================================ */
.subsection p {
  color: var(--text-secondary);
  line-height: 1.85;
  margin-block-end: 0.85rem;
  text-wrap: pretty;
}

.subsection ul,
.subsection ol {
  margin-block: 0.75rem 1rem;
  padding-inline-start: 1.5rem;
}

.subsection li {
  color: var(--text-secondary);
  line-height: 1.85;
  margin-block-end: 0.35rem;
}

.subsection li::marker {
  color: var(--text-tertiary);
}

.subsection strong {
  color: var(--text-primary);
  font-weight: 600;
}

/* ============================================
   Inline Code
   ============================================ */
.subsection code {
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Cascadia Code", "Consolas", monospace;
  font-size: 0.85em;
  background: var(--accent-ghost);
  color: var(--accent-strong);
  padding: 0.15em 0.45em;
  border-radius: 3px;
  font-feature-settings: "calt" 1, "liga" 1;
  word-break: break-word;
}

/* ============================================
   Links
   ============================================ */
a {
  color: var(--accent-strong);
  text-decoration: underline;
  text-decoration-thickness: 0.06em;
  text-underline-offset: 0.2em;
  text-decoration-color: var(--accent-muted);
  transition: color var(--duration-fast) var(--ease-out-quart),
              text-decoration-color var(--duration-fast) var(--ease-out-quart);
}

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

a:active {
  color: var(--accent-strong);
}

/* ============================================
   Tables
   ============================================ */
.table-wrap {
  overflow-x: auto;
  margin-block: var(--space-element);
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-md);
  background: var(--bg-elevated);
}

table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.875rem;
  font-feature-settings: "tnum" 1;
}

thead {
  background: var(--bg-surface-alt);
}

th {
  padding: 0.65rem 1rem;
  text-align: start;
  font-weight: 600;
  font-size: 0.8125rem;
  color: var(--accent-strong);
  border-block-end: 2px solid var(--accent-ghost);
  white-space: nowrap;
  letter-spacing: 0.02em;
}

td {
  padding: 0.6rem 1rem;
  color: var(--text-secondary);
  border-block-end: 1px solid var(--border-subtle);
  line-height: 1.65;
  vertical-align: top;
}

tbody tr:last-child td {
  border-block-end: none;
}

tbody tr:nth-child(even) {
  background: var(--bg-surface-alt);
}

tbody tr:hover {
  background: var(--accent-ghost);
}

td code,
th code {
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Cascadia Code", "Consolas", monospace;
  font-size: 0.85em;
  background: var(--accent-ghost);
  color: var(--accent-strong);
  padding: 0.12em 0.4em;
  border-radius: 2px;
}

/* ----- Tags in tables ----- */
.tag {
  display: inline-block;
  font-size: 0.6875rem;
  font-weight: 600;
  padding: 0.15em 0.55em;
  border-radius: 3px;
  letter-spacing: 0.03em;
  background: var(--accent-ghost);
  color: var(--accent);
}

/* ============================================
   Code Blocks
   ============================================ */
.code-block-wrapper {
  position: relative;
  margin-block: var(--space-element);
  border: 1px solid var(--code-border);
  border-radius: var(--radius-md);
  overflow: hidden;
  background: var(--code-bg);
}

.code-block-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0.4rem 0.85rem;
  background: var(--bg-surface-alt);
  border-block-end: 1px solid var(--code-border);
}

.code-block-lang {
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Consolas", monospace;
  font-size: 0.6875rem;
  font-weight: 500;
  color: var(--text-tertiary);
  letter-spacing: 0.05em;
  text-transform: uppercase;
}

.code-copy-btn {
  display: inline-flex;
  align-items: center;
  gap: 0.3rem;
  padding: 0.2rem 0.5rem;
  border: 1px solid var(--border-subtle);
  border-radius: var(--radius-sm);
  background: var(--bg-elevated);
  color: var(--text-tertiary);
  font-size: 0.6875rem;
  font-family: inherit;
  cursor: pointer;
  transition: all var(--duration-fast) var(--ease-out-quart);
}

.code-copy-btn:hover {
  border-color: var(--accent-muted);
  color: var(--accent);
}

.code-copy-btn:active {
  background: var(--accent-ghost);
}

.code-copy-btn.copied {
  border-color: var(--accent);
  color: var(--accent);
  background: var(--accent-ghost);
}

.code-copy-btn svg {
  width: 14px;
  height: 14px;
  stroke: currentColor;
  fill: none;
  stroke-width: 2;
  stroke-linecap: round;
  stroke-linejoin: round;
}

pre {
  padding: 1rem 1.1rem;
  overflow-x: auto;
  font-size: 0.8125rem;
  line-height: 1.75;
  tab-size: 2;
  -moz-tab-size: 2;
  background: var(--code-bg);
}

pre code {
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Cascadia Code", "Consolas", monospace;
  color: var(--code-text);
  background: none;
  border: none;
  padding: 0;
  font-size: inherit;
  font-feature-settings: "calt" 1, "liga" 1;
}

/* Standalone <pre> (not wrapped in .code-block-wrapper) */
pre:not(.code-block-wrapper pre) {
  border: 1px solid var(--code-border);
  border-radius: var(--radius-md);
  margin-block: var(--space-element);
}

pre:not(.code-block-wrapper pre) code {
  color: var(--code-text);
}

/* Syntax tokens — applied by JS or inline spans */
.code-kw  { color: var(--code-keyword); font-weight: 600; }
.code-cmt { color: var(--code-comment); font-style: italic; }
.code-str { color: var(--code-string); }
.code-num { color: var(--code-number); }
.code-fn  { color: var(--accent-strong); }

/* ============================================
   Blockquotes
   ============================================ */
blockquote {
  margin-block: var(--space-element);
  padding: 0.85rem 1.1rem;
  background: var(--bg-surface-alt);
  border-inline-start: 3px solid var(--accent-muted);
  border-radius: 0 var(--radius-sm) var(--radius-sm) 0;
}

blockquote p {
  color: var(--text-secondary);
  font-size: 0.9375rem;
  line-height: 1.75;
  margin: 0;
}

blockquote code {
  background: var(--accent-ghost);
  color: var(--accent-strong);
}

/* ============================================
   Callouts (Info / Tip / Warning)
   ============================================ */
.callout {
  position: relative;
  margin-block: var(--space-element);
  padding: 0.9rem 1.1rem 0.9rem 2.6rem;
  border-radius: var(--radius-md);
  border-inline-start: 3px solid;
  font-size: 0.9rem;
  line-height: 1.7;
}

.callout::before {
  position: absolute;
  inset-inline-start: 0.7rem;
  inset-block-start: 0.85rem;
  font-size: 1rem;
  font-weight: 700;
  line-height: 1;
}

.callout p {
  margin-block-end: 0.4rem;
}

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

.callout code {
  font-size: 0.85em;
  padding: 0.1em 0.4em;
  border-radius: 2px;
}

/* Info */
.callout--info {
  background: var(--info-bg);
  border-color: var(--info-border);
  color: var(--info-text);
}

.callout--info::before { content: "ⓘ"; }
.callout--info code { background: oklch(0.55 0.08 230 / 0.15); color: var(--info-text); }

/* Tip */
.callout--tip {
  background: var(--tip-bg);
  border-color: var(--tip-border);
  color: var(--tip-text);
}

.callout--tip::before { content: "✦"; }
.callout--tip code { background: oklch(0.45 0.10 160 / 0.15); color: var(--tip-text); }

/* Warning */
.callout--warning {
  background: var(--warn-bg);
  border-color: var(--warn-border);
  color: var(--warn-text);
}

.callout--warning::before { content: "▲"; }
.callout--warning code { background: oklch(0.50 0.12 50 / 0.15); color: var(--warn-text); }

/* ============================================
   Object Tree
   ============================================ */
.object-tree {
  margin-block: var(--space-element);
  padding: 1.1rem 1.3rem;
  background: var(--code-bg);
  border: 1px solid var(--code-border);
  border-radius: var(--radius-md);
  font-family: "JetBrains Mono", "Fira Code", "SF Mono", "Consolas", monospace;
  font-size: 0.8125rem;
  line-height: 1.9;
  color: var(--code-text);
  overflow-x: auto;
  white-space: pre;
  font-feature-settings: "calt" 0;
}

/* ============================================
   Image Placeholder / Loading
   ============================================ */
.img-placeholder {
  display: flex;
  align-items: center;
  justify-content: center;
  background: var(--bg-surface-alt);
  border: 1px dashed var(--border-default);
  border-radius: var(--radius-md);
  color: var(--text-tertiary);
  font-size: var(--text-sm);
  min-block-size: 200px;
  margin-block: var(--space-element);
}

/* ============================================
   Empty / Loading / Error States
   ============================================ */
.state-empty,
.state-loading,
.state-error {
  display: flex;
  flex-direction: column;
  align-items: center;
  justify-content: center;
  padding: 3rem 1.5rem;
  text-align: center;
  color: var(--text-tertiary);
  font-size: var(--text-sm);
  line-height: 1.7;
  border: 1px dashed var(--border-default);
  border-radius: var(--radius-md);
  background: var(--bg-surface-alt);
  margin-block: var(--space-element);
}

.state-empty::before {
  content: "";
  display: block;
  width: 40px;
  height: 40px;
  margin-block-end: 1rem;
  background: var(--border-subtle);
  border-radius: 50%;
  mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='1.5'%3E%3Cpath d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z'/%3E%3Cpolyline points='14 2 14 8 20 8'/%3E%3C/svg%3E") center / contain no-repeat;
  -webkit-mask: url("data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='1.5'%3E%3Cpath d='M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z'/%3E%3Cpolyline points='14 2 14 8 20 8'/%3E%3C/svg%3E") center / contain no-repeat;
}

.state-loading::before {
  content: "";
  display: block;
  width: 28px;
  height: 28px;
  margin-block-end: 1rem;
  border: 2px solid var(--border-default);
  border-block-start-color: var(--accent);
  border-radius: 50%;
  animation: spin 0.8s linear infinite;
}

.state-error::before {
  content: "!";
  display: flex;
  align-items: center;
  justify-content: center;
  width: 36px;
  height: 36px;
  margin-block-end: 0.75rem;
  border: 2px solid var(--warn-border);
  border-radius: 50%;
  color: var(--warn-text);
  font-weight: 700;
  font-size: 1.2rem;
}

@keyframes spin {
  to { transform: rotate(360deg); }
}

/* ============================================
   Divider
   ============================================ */
.section-divider {
  border: none;
  block-size: 1px;
  background: var(--border-subtle);
  margin-block: var(--space-block);
}

/* ============================================
   Footer
   ============================================ */
.doc-footer {
  margin-block-start: var(--space-section);
  padding-block-start: var(--space-block);
  border-block-start: 1px solid var(--border-subtle);
  text-align: center;
  color: var(--text-tertiary);
  font-size: var(--text-xs);
  line-height: 1.8;
}

.doc-footer p {
  margin-block-end: 0.3rem;
}

.doc-footer a {
  font-weight: 500;
}

/* ============================================
   Mobile Menu Toggle
   ============================================ */
.menu-toggle {
  display: none;
  position: fixed;
  inset-block-start: 1rem;
  inset-inline-start: 1rem;
  z-index: 200;
  inline-size: 44px;
  block-size: 44px;
  background: var(--bg-surface);
  border: 1px solid var(--border-default);
  border-radius: var(--radius-sm);
  cursor: pointer;
  align-items: center;
  justify-content: center;
  box-shadow: var(--shadow-md);
  transition: background var(--duration-fast) var(--ease-out-quart);
}

.menu-toggle:hover {
  background: var(--bg-surface-alt);
}

.menu-toggle:active {
  background: var(--accent-ghost);
}

.menu-toggle .hamburger {
  display: flex;
  flex-direction: column;
  gap: 4px;
  pointer-events: none;
}

.menu-toggle .hamburger span {
  display: block;
  inline-size: 18px;
  block-size: 1.5px;
  background: var(--text-primary);
  border-radius: 1px;
  transition: transform var(--duration-base) var(--ease-out-expo),
              opacity var(--duration-base) var(--ease-out-expo);
}

/* Sidebar overlay for mobile */
.sidebar-overlay {
  display: none;
  position: fixed;
  inset: 0;
  background: oklch(0.1 0.01 170 / 0.4);
  z-index: 99;
  opacity: 0;
  transition: opacity var(--duration-base) var(--ease-out-quart);
  pointer-events: none;
}

/* ============================================
   Animations (respects prefers-reduced-motion)
   ============================================ */
@media (prefers-reduced-motion: reduce) {
  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }

  html {
    scroll-behavior: auto;
  }
}

/* ============================================
   Responsive — ≤1024px (tablet)
   ============================================ */
@media (max-width: 1024px) {
  :root {
    --sidebar-width: 280px;
    --content-max: none;
  }

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

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

  .sidebar-overlay {
    display: block;
  }

  .sidebar-overlay.visible {
    opacity: 1;
    pointer-events: auto;
  }

  .main-content {
    margin-inline-start: 0;
  }

  .menu-toggle {
    display: flex;
  }

  .content-inner {
    padding-block-start: clamp(4rem, 5rem + 1vw, 5rem);
  }
}

/* ============================================
   Responsive — ≤768px (mobile)
   ============================================ */
@media (max-width: 768px) {
  :root {
    --sidebar-width: 280px;
  }

  .hero h1 {
    font-size: clamp(1.5rem, 1.3rem + 1.2vw, 1.75rem);
  }

  .hero-meta {
    gap: 1.25rem;
  }

  .hero-meta-item .num {
    font-size: clamp(1.25rem, 1.1rem + 0.6vw, 1.5rem);
  }

  .section-header {
    gap: 0.75rem;
  }

  .section-number {
    min-inline-size: 2rem;
    min-block-size: 2rem;
    font-size: 0.8125rem;
  }

  /* Table: allow horizontal scroll but keep readable */
  .table-wrap {
    border-radius: var(--radius-sm);
  }

  table {
    font-size: 0.8125rem;
  }

  th,
  td {
    padding: 0.5rem 0.7rem;
  }

  /* Code blocks: ensure scrollable */
  pre {
    font-size: 0.75rem;
    padding: 0.85rem;
  }

  /* Callouts: reduce padding */
  .callout {
    padding: 0.75rem 0.85rem 0.75rem 2.2rem;
    font-size: 0.85rem;
  }

  .callout::before {
    inset-inline-start: 0.5rem;
  }

  blockquote {
    padding: 0.7rem 0.85rem;
  }
}

/* ============================================
   Responsive — ≤480px (small mobile)
   ============================================ */
@media (max-width: 480px) {
  :root {
    --sidebar-width: 100%;
  }

  .content-inner {
    padding-inline: 1rem;
  }

  .hero-meta {
    flex-direction: row;
    gap: 1rem;
  }

  .hero-meta-item .num {
    font-size: 1.25rem;
  }

  .subsection h3 {
    padding-inline-start: 0.6rem;
  }

  .code-block-header {
    padding: 0.3rem 0.6rem;
  }

  .code-copy-btn span {
    display: none;
  }
}

/* ============================================
   Print Styles
   ============================================ */
@media print {
  .sidebar,
  .menu-toggle,
  .sidebar-overlay,
  .theme-toggle,
  .code-copy-btn,
  .code-block-header {
    display: none !important;
  }

  .main-content {
    margin-inline-start: 0;
  }

  .content-inner {
    max-width: none;
    padding: 0;
  }

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

  .section {
    page-break-before: always;
    border: none;
    padding: 0;
  }

  .hero {
    page-break-before: avoid;
    border: none;
  }

  pre,
  .code-block-wrapper,
  .object-tree {
    background: #f8f8f8;
    border: 1px solid #ddd;
    page-break-inside: avoid;
  }

  a {
    color: inherit;
    text-decoration: underline;
  }
}