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

:root {
  --transition: 0.2s ease;
}

/* "Foundry Night" -- warm charcoal-brown ground, ember accent (dark theme).
   Shares the manual's palette (documentation.html) so tutorials read as the
   same identity. */
[data-theme="dark"] {
  --bg: #211a14;
  --bg-secondary: #2a2119;
  --bg-sidebar: #1b140f;
  --bg-code: #171009;
  --bg-table-alt: #2a2119;
  --bg-table-header: #332821;
  --text: #e8dfd0;
  --text-muted: #a69784;
  --text-heading: #f5eedf;
  --border: #3d3025;
  --link: #d8665a;
  --link-hover: #ef9585;
  --accent: #d8665a;
  --accent-dim: #a84c42;
  --note-bg: #1e2a19;
  --note-border: #6b8f5c;
  --note-text: #c8dbb8;
  --warn-bg: #332616;
  --warn-border: #c89040;
  --warn-text: #ebcf9c;
  --badge-bg: #3d2e22;
  --badge-text: #e8dfd0;
  --scrollbar-track: #1b140f;
  --scrollbar-thumb: #3d3025;
  --active-bg: #332821;
  --search-bg: #2a2119;
  --search-border: #3d3025;
  --hamburger: #e8dfd0;
  --shadow: rgba(10,7,4,0.5);
  /* Syntax highlighting -- ember-brightened for a near-black warm ground */
  --syn-keyword: #e08868;
  --syn-string: #9fc48a;
  --syn-comment: #8f8070;
  --syn-type: #7fc4b8;
  --syn-number: #d9b168;
  --syn-attr: #c7a0d8;
  --syn-method: #d9b87a;
  --syn-punctuation: #d8cbb8;
  --syn-operator: #d8cbb8;
}

/* "Parchment" -- warm ivory ground, oxblood accent (light theme, default identity) */
[data-theme="light"] {
  --bg: #f6efe2;
  --bg-secondary: #efe5d3;
  --bg-sidebar: #ece1cc;
  --bg-code: #e7d9bf;
  --bg-table-alt: #efe5d3;
  --bg-table-header: #e3d6bc;
  --text: #2b2117;
  --text-muted: #6b5d4d;
  --text-heading: #1f1710;
  --border: #d8c8ac;
  --link: #8a2e2e;
  --link-hover: #6e2222;
  --accent: #8a2e2e;
  --accent-dim: #6e2222;
  --note-bg: #e9efe0;
  --note-border: #5b7a52;
  --note-text: #33472c;
  --warn-bg: #f5e6c8;
  --warn-border: #8f631a;
  --warn-text: #5c4419;
  --badge-bg: #e3d6bc;
  --badge-text: #4a3b2c;
  --scrollbar-track: #ece1cc;
  --scrollbar-thumb: #c9b98f;
  --active-bg: #e3d6bc;
  --search-bg: #fbf7ee;
  --search-border: #d8c8ac;
  --hamburger: #2b2117;
  --shadow: rgba(43,33,23,0.16);
  /* Syntax highlighting -- ink family tuned for a warm kraft-paper code block */
  --syn-keyword: #8a3324;
  --syn-string: #3f6b33;
  --syn-comment: #665741;
  --syn-type: #2e6b63;
  --syn-number: #8a6a1e;
  --syn-attr: #5a3b6b;
  --syn-method: #6b4423;
  --syn-punctuation: #4a3b2c;
  --syn-operator: #4a3b2c;
}

/* ===== Base Styles ===== */
body {
  background: var(--bg);
  color: var(--text);
  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif;
  line-height: 1.7;
}

h1, h2, h3, h4, h5, h6 {
  font-family: Georgia, 'Iowan Old Style', 'Palatino Linotype', 'Book Antiqua', Palatino, serif;
  color: var(--text-heading);
  letter-spacing: -0.01em;
}

a {
  color: var(--link);
}

a:hover {
  color: var(--link-hover);
}

code {
  font-family: 'Cascadia Code', 'Fira Code', Consolas, monospace;
}

/* ===== Layout ===== */
main {
  max-width: 800px;
  margin: 72px auto 0;
  padding: 0 2rem 2rem;
}

/* ===== Header Bar ===== */
.top-bar {
  position: fixed;
  top: 0;
  left: 0;
  width: 100%;
  height: 56px;
  background: var(--bg-sidebar);
  border-bottom: 1px solid var(--border);
  z-index: 100;
  display: flex;
  align-items: center;
  justify-content: space-between;
  padding: 0 2rem;
}

.top-bar .logo {
  font-weight: bold;
  color: var(--accent);
}

.top-bar .theme-toggle {
  background: none;
  border: none;
  cursor: pointer;
  color: var(--text);
  font-size: 1.25rem;
}

/* ===== Code Blocks ===== */
pre {
  margin: 1rem 0;
  position: relative;
}

pre > code {
  display: block;
  background: var(--bg-code);
  border: 1px solid var(--border);
  border-radius: 6px;
  padding: 1.25rem;
  overflow-x: auto;
  font-size: 0.9rem;
  line-height: 1.5;
}

code {
  background: var(--bg-code);
  padding: 0.15em 0.4em;
  border-radius: 3px;
}

pre > code {
  padding: 1.25rem;
}

/* Syntax highlighting */
.kw { color: var(--syn-keyword); }
.str { color: var(--syn-string); }
.cmt { color: var(--syn-comment); }
.typ { color: var(--syn-type); }
.num { color: var(--syn-number); }
.method { color: var(--syn-method); }
.punc { color: var(--syn-punctuation); }
.attr { color: var(--syn-attr); }

/* XML/WiX syntax */
.xml-tag { color: var(--syn-keyword); }
.xml-attr { color: var(--syn-attr); }
.xml-val { color: var(--syn-string); }

/* ===== Copy Button ===== */
.copy-btn {
  position: absolute;
  top: 8px;
  right: 8px;
  background: var(--bg-secondary);
  border: 1px solid var(--border);
  color: var(--text-muted);
  cursor: pointer;
  border-radius: 4px;
  padding: 4px 8px;
  font-size: 0.75rem;
}

/* ===== Collapsible Deep-Dives ===== */
details.deep-dive {
  margin: 1rem 0;
}

details.deep-dive summary {
  cursor: pointer;
  color: var(--accent);
  font-weight: 600;
  padding: 0.5rem 0;
  user-select: none;
  list-style: none;
}

details.deep-dive summary::-webkit-details-marker {
  display: none;
}

details.deep-dive summary::before {
  content: '\25B6';
  display: inline-block;
  margin-right: 0.5rem;
  transition: transform 0.2s;
  font-size: 0.75em;
}

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

details.deep-dive[open] > .deep-dive-content {
  border-left: 3px solid var(--accent);
  padding: 1rem;
  margin: 0.5rem 0 0.5rem 0.5rem;
  background: var(--bg-secondary);
  border-radius: 0 6px 6px 0;
}

/* ===== Tutorial Metadata ===== */
.tutorial-meta {
  color: var(--text-muted);
  font-size: 0.9rem;
  border-bottom: 1px solid var(--border);
  padding-bottom: 1rem;
  margin-bottom: 2rem;
}

/* ===== Side-by-Side Comparison ===== */
.comparison {
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 1rem;
}

.comparison-label {
  font-weight: 600;
  font-size: 0.85rem;
  text-transform: uppercase;
  letter-spacing: 0.05em;
  color: var(--text-muted);
  margin-bottom: 0.5rem;
}

/* ===== Note & Warning ===== */
.note {
  background: var(--note-bg);
  border-left: 4px solid var(--note-border);
  color: var(--note-text);
  padding: 1rem;
  border-radius: 0 6px 6px 0;
  margin: 1rem 0;
}

.warning {
  background: var(--warn-bg);
  border-left: 4px solid var(--warn-border);
  color: var(--warn-text);
  padding: 1rem;
  border-radius: 0 6px 6px 0;
  margin: 1rem 0;
}

/* ===== Tables ===== */
table {
  width: 100%;
  border-collapse: collapse;
}

th {
  background: var(--bg-table-header);
  text-align: left;
  padding: 0.75rem;
}

td {
  padding: 0.75rem;
  border-bottom: 1px solid var(--border);
}

tr:nth-child(even) td {
  background: var(--bg-table-alt);
}

/* ===== Tutorial Cards (Index Page) ===== */
.tutorial-card {
  border: 1px solid var(--border);
  border-radius: 8px;
  padding: 1.25rem;
  margin-bottom: 1rem;
  transition: background 0.2s;
}

.tutorial-card:hover {
  background: var(--bg-secondary);
}

.tutorial-card a {
  font-size: 1.1rem;
  font-weight: 600;
  text-decoration: none;
  color: var(--link);
}

.tutorial-card p {
  color: var(--text-muted);
  margin-top: 0.5rem;
  font-size: 0.95rem;
}

.tutorial-card .meta {
  font-size: 0.8rem;
  color: var(--text-muted);
}

.tutorial-card.coming-soon {
  opacity: 0.5;
}

.tutorial-card.coming-soon span:first-child {
  font-size: 1.1rem;
  font-weight: 600;
  color: var(--text);
}

/* ===== Tutorial Nav Footer ===== */
.tutorial-nav {
  display: flex;
  justify-content: space-between;
  margin-top: 3rem;
  padding-top: 1.5rem;
  border-top: 1px solid var(--border);
}

.tutorial-nav a {
  padding: 0.5rem 1.25rem;
  border: 1px solid var(--border);
  border-radius: 20px;
  text-decoration: none;
  color: var(--link);
  transition: all 0.2s;
}

.tutorial-nav a:hover {
  background: var(--bg-secondary);
  border-color: var(--accent);
}

/* ===== Spacing ===== */
h1 { margin: 1.5rem 0 1rem; }
h2 { margin: 2.5rem 0 1rem; padding-top: 1rem; }
h3 { margin: 2rem 0 0.75rem; }
p { margin: 0.75rem 0; }
ul, ol { margin: 0.75rem 0; padding-left: 1.5rem; }

/* ===== Responsive ===== */
@media (max-width: 768px) {
  main {
    padding: 0 1rem 1rem;
  }

  h1 {
    font-size: 1.5rem;
  }

  .top-bar {
    padding: 0 1rem;
  }

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