/* ============================================================
   STM32 Tutorial — Unified Theme Tokens
   Single accent (STM32 orange). Dark default + light override.
   Every legacy variable name used by the pages is aliased here,
   so a page only needs to DELETE its local :root color block.
   ============================================================ */

:root{
  color-scheme: dark;

  /* ── Core surfaces & ink (DARK) ── */
  --bg:        #0e1218;
  --paper:     #161c26;
  --paper2:    #1e2634;
  --ink:       #e7edf6;
  --dim:       #97a3b6;
  --faint:     #626d80;
  --rule:      #232c3a;
  --rule2:     #313c4e;

  /* ── Code block sub-theme (stays dark in both modes) ── */
  --code-bg:   #0b0e14;
  --code-fg:   #d7e0ee;
  --code-text: #d7e0ee;

  /* ── Primary accent — STM32 orange ── */
  --accent:      #ef6c1a;
  --accent-ink:  #ffffff;
  --accent-soft: rgba(239,108,26,.15);

  /* ── Supporting categorical palette (structure, not brand) ── */
  --c-blue:   #6fb3e2;
  --c-green:  #5edb9a;
  --c-amber:  #e2b96f;
  --c-red:    #e2735e;
  --c-purple: #c49be8;

  /* ── Callout tints ── */
  --tint-accent: rgba(239,108,26,.12);
  --tint-warn:   rgba(226,115,94,.13);
  --tint-ok:     rgba(94,219,154,.11);
  --tint-info:   rgba(111,179,226,.11);
  --tint-note:   rgba(226,185,111,.11);

  /* ── Legacy aliases → unified tokens ── */
  --acc:  var(--accent);
  --acc1: var(--accent);
  --accent2: var(--c-blue);   --acc2: var(--c-blue);
  --accent3: var(--c-green);  --acc3: var(--c-green);
  --accent4: var(--c-purple); --acc4: var(--c-purple);
  --accent5: var(--c-amber);  --acc5: var(--c-amber);

  /* ch13-14 semantic accents */
  --acc-dac:  var(--accent);
  --acc-adc:  var(--c-blue);
  --acc-ok:   var(--c-green);
  --acc-warn: var(--c-amber);
  --acc-red:  var(--c-red);

  /* HAL/LL edition semantics (kept distinct as structure) */
  --hal:  var(--c-green);
  --ll:   var(--c-amber);
  --spl:  var(--dim);
  --warn: var(--c-red);

  /* Yellow callout family */
  --yellow:        var(--tint-note);
  --yellow-border: var(--c-amber);
  --yellow-text:   var(--c-amber);

  /* Concept-map names */
  --text:        var(--ink);
  --node-bg:     var(--paper);
  --node-border: var(--rule2);
  --grid:        rgba(239,108,26,.05);

  /* Shell names */
  --card:   var(--paper);
  --card2:  var(--paper2);
  --side:   #141a24;
  --side2:  #0c1017;
  --notes:  var(--accent);
  --map:    var(--accent);
  --sidebar-w: 290px;
  --topbar-h:  52px;

  --theme-ease: background-color .35s ease, color .35s ease, border-color .35s ease;
}

/* ============================================================
   LIGHT MODE
   ============================================================ */
html[data-theme="light"]{
  color-scheme: light;

  --bg:        #f7f3eb;
  --paper:     #fdfaf5;
  --paper2:    #f0ebe0;
  --ink:       #1a1510;
  --dim:       #6b6355;
  --faint:     #9a9080;
  --rule:      #e0d8c8;
  --rule2:     #cfc5b2;

  /* code blocks remain dark for contrast (GitHub-style) */
  --code-bg:   #1a1510;
  --code-fg:   #e8dcc8;
  --code-text: #e8dcc8;

  --accent:      #b5410b;
  --accent-ink:  #ffffff;
  --accent-soft: rgba(181,65,11,.10);

  --c-blue:   #1a5c7a;
  --c-green:  #2d6a2d;
  --c-amber:  #8b5a00;
  --c-red:    #b23a2e;
  --c-purple: #6b3fa0;

  --tint-accent: #fbeee6;
  --tint-warn:   #fdf0ec;
  --tint-ok:     #eef6f1;
  --tint-info:   #eef4fb;
  --tint-note:   #fdf6e7;

  --grid: rgba(120,90,40,.06);

  --side:   #efe9dd;
  --side2:  #e7dfce;
}

/* Smooth cross-fade when switching (bg/text driven by the tokens) */
html[data-theme] body{ transition: var(--theme-ease); }

/* ============================================================
   Floating theme toggle (injected by theme.js on standalone pages)
   ============================================================ */
#__themeToggle{
  position: fixed; right: 18px; bottom: 18px; z-index: 99999;
  width: 44px; height: 44px; border-radius: 50%;
  display: flex; align-items: center; justify-content: center;
  font-size: 19px; line-height: 1; cursor: pointer;
  background: var(--paper); color: var(--accent);
  border: 1px solid var(--rule2);
  box-shadow: 0 4px 18px rgba(0,0,0,.28);
  transition: transform .15s ease, var(--theme-ease);
  font-family: system-ui, sans-serif;
}
#__themeToggle:hover{ transform: translateY(-2px) scale(1.05); border-color: var(--accent); }
#__themeToggle:active{ transform: translateY(0) scale(.97); }

/* ============================================================
   Diagram kit — reusable primitives for structural diagrams
   (block/flow diagrams, hierarchies, memory & data layouts,
   bus topologies, protocol frames). Theme-aware via tokens.
   ============================================================ */
.dgm{ margin:20px 0; font-family:'DM Sans',sans-serif; }
.dgm-cap{ font-family:'IBM Plex Mono',monospace; font-size:10px; letter-spacing:2px; text-transform:uppercase; color:var(--dim); margin-bottom:14px; }
.dgm-note{ font-size:12px; color:var(--dim); margin-top:10px; font-style:italic; }

/* generic node/box */
.dgm-node{ display:inline-flex; flex-direction:column; gap:2px; background:var(--paper); border:1px solid var(--rule2); border-radius:8px; padding:10px 14px; color:var(--ink); text-align:center; }
.dgm-node .nt{ font-weight:700; font-size:14px; color:var(--ink); }
.dgm-node .ns{ font-family:'IBM Plex Mono',monospace; font-size:10px; color:var(--dim); }
.dgm-node.accent{ background:var(--tint-accent); border-color:var(--accent); }
.dgm-node.blue{ background:var(--tint-info); border-color:var(--c-blue); }
.dgm-node.green{ background:var(--tint-ok); border-color:var(--c-green); }
.dgm-node.amber{ background:var(--tint-note); border-color:var(--c-amber); }
.dgm-node.warn{ background:var(--tint-warn); border-color:var(--c-red); }

/* horizontal flow: nodes separated by arrows (wraps on small screens) */
.dgm-flow{ display:flex; flex-wrap:wrap; align-items:center; gap:10px; }
.dgm-flow .dgm-node{ flex:0 1 auto; }
.dgm-arrow{ color:var(--accent); font-family:'IBM Plex Mono',monospace; font-weight:700; font-size:16px; flex:0 0 auto; display:flex; flex-direction:column; align-items:center; line-height:1; }
.dgm-arrow .al{ font-size:9px; color:var(--dim); letter-spacing:.5px; font-weight:400; margin-top:2px; white-space:nowrap; }

/* vertical stack — memory / data layouts */
.dgm-stack{ border:1px solid var(--rule2); border-radius:8px; overflow:hidden; max-width:560px; }
.dgm-row{ padding:11px 15px; border-bottom:1px solid var(--rule2); position:relative; background:var(--paper); }
.dgm-row:last-child{ border-bottom:none; }
.dgm-row .rn{ font-weight:700; font-size:13.5px; color:var(--ink); }
.dgm-row .rs{ font-size:12px; color:var(--dim); margin-top:1px; padding-right:96px; }
.dgm-row .rp{ position:absolute; right:15px; top:12px; font-family:'IBM Plex Mono',monospace; font-size:11px; color:var(--accent); font-weight:600; }
.dgm-row.accent{ background:var(--tint-accent); }
.dgm-row.blue{ background:var(--tint-info); }
.dgm-row.green{ background:var(--tint-ok); }
.dgm-row.amber{ background:var(--tint-note); }
.dgm-row.warn{ background:var(--tint-warn); }
.dgm-edge{ display:flex; justify-content:space-between; font-family:'IBM Plex Mono',monospace; font-size:11px; color:var(--dim); padding:4px 2px; }

/* connector between stacked elements */
.dgm-conn{ display:flex; flex-direction:column; align-items:center; gap:3px; color:var(--dim); font-family:'IBM Plex Mono',monospace; font-size:10.5px; letter-spacing:.5px; padding:5px 0; }
.dgm-conn i{ width:1px; height:12px; background:var(--rule2); display:block; }

/* bus band — hierarchy levels with a colored spine */
.dgm-band{ border:1px solid var(--rule2); border-left:4px solid var(--accent); border-radius:8px; padding:12px 15px; background:var(--paper); }
.dgm-band .bl{ font-family:'IBM Plex Mono',monospace; font-size:11px; font-weight:600; letter-spacing:1px; text-transform:uppercase; color:var(--accent); display:flex; flex-wrap:wrap; justify-content:space-between; align-items:baseline; gap:6px 12px; margin-bottom:10px; }
.dgm-band .bl .hz{ font-weight:400; color:var(--dim); font-size:10px; letter-spacing:.5px; text-transform:none; }
.dgm-band.blue{ border-left-color:var(--c-blue); } .dgm-band.blue .bl{ color:var(--c-blue); }
.dgm-band.green{ border-left-color:var(--c-green); } .dgm-band.green .bl{ color:var(--c-green); }
.dgm-band.amber{ border-left-color:var(--c-amber); } .dgm-band.amber .bl{ color:var(--c-amber); }

/* chips row — small labelled items */
.dgm-chips{ display:flex; flex-wrap:wrap; gap:7px; }
.dgm-chips span{ font-family:'IBM Plex Mono',monospace; font-size:11.5px; background:var(--paper2); border:1px solid var(--rule); border-radius:5px; padding:4px 9px; color:var(--ink); }

/* protocol frame — a strip of labelled fields */
.dgm-fields{ display:flex; flex-wrap:wrap; border-radius:6px; overflow:hidden; border:1px solid var(--rule2); font-family:'IBM Plex Mono',monospace; font-size:11px; }
.dgm-fields .fld{ padding:8px 11px; border-right:1px solid var(--rule2); background:var(--paper); color:var(--ink); white-space:nowrap; }
.dgm-fields .fld:last-child{ border-right:none; }
.dgm-fields .fld.k{ background:var(--tint-accent); font-weight:600; }
.dgm-fields .fld.g{ background:var(--tint-ok); }
.dgm-fields .fld.b{ background:var(--tint-info); }

/* side-by-side columns */
.dgm-cols{ display:flex; gap:10px; flex-wrap:wrap; }
.dgm-cols>*{ flex:1; min-width:220px; }
.dgm-colcap{ font-family:'IBM Plex Mono',monospace; font-size:10.5px; letter-spacing:1px; text-transform:uppercase; color:var(--dim); margin-bottom:6px; }
