/* ============================================================
   North7 Design Tokens — snapshot of design/tokens/tokens.css
   Conforms to design/DESIGN.md v0.1.0. Re-sync by copying the
   canonical block; do not hand-merge.
   ------------------------------------------------------------
   Fonts are loaded via <link> in index.html <head>
   (faster than @import here, parallel-fetched with this CSS).
   ============================================================ */

:root {
  /* Type families */
  --font-display: "Instrument Serif", "Iowan Old Style", Georgia, serif;
  --font-sans:    "Geist", ui-sans-serif, system-ui, -apple-system, "Helvetica Neue", sans-serif;
  --font-mono:    "JetBrains Mono", ui-monospace, "SF Mono", Menlo, Consolas, monospace;

  /* Type scale */
  --fs-xs:    0.75rem;
  --fs-sm:    0.875rem;
  --fs-base:  1rem;
  --fs-md:    1.125rem;
  --fs-lg:    1.375rem;
  --fs-xl:    1.75rem;
  --fs-2xl:   2.25rem;
  --fs-3xl:   3rem;
  --fs-4xl:   4rem;

  /* Spacing (4px base) */
  --sp-1: 0.25rem;
  --sp-2: 0.5rem;
  --sp-3: 0.75rem;
  --sp-4: 1rem;
  --sp-5: 1.5rem;
  --sp-6: 2rem;
  --sp-7: 3rem;
  --sp-8: 4rem;

  /* Radii */
  --r-xs:  4px;
  --r-sm:  6px;
  --r-md:  10px;
  --r-lg:  14px;
  --r-xl:  20px;

  /* Brand palette (shared across themes) */
  --pine-50:  #ECF2EE; --pine-100: #D4E2D7; --pine-200: #A8C4AE;
  --pine-300: #74A07E; --pine-400: #4B7D58; --pine-500: #2F5C3D;
  --pine-600: #224730; --pine-700: #183524; --pine-800: #0F2317;

  --ember-50:  #FBEFE8; --ember-100: #F6DAC9; --ember-200: #EFB695;
  --ember-300: #E58F61; --ember-400: #D26B3A; --ember-500: #B0532A;
  --ember-600: #8A3F1E; --ember-700: #5F2B14;

  --sky-50: #ECF1F4; --sky-100: #D2DEE7; --sky-200: #A3BDCD;
  --sky-300: #6E96AE; --sky-400: #467289; --sky-500: #2F5468;

  --sand-50: #F6EFE3; --sand-100: #ECDFC4; --sand-200: #DDC79B;
  --sand-300: #C7A972;

  /* Motion */
  --ease-out: cubic-bezier(0.22, 1, 0.36, 1);
  --t-fast: 120ms;
  --t-base: 220ms;

  /* App shell layout (DESIGN.md §4) */
  --header-height: 64px;
  --footer-height: 56px;
  --sidebar-width: 280px;
  --nav-width:     var(--sidebar-width); /* legacy alias */
  --toc-width:     220px;
  --content-max:   62rem;
  --page-padding:  var(--sp-5);
}

/* Light (default) */
:root,
[data-theme="light"] {
  --bg:         #FAF7F1;
  --bg-soft:    #F2EDE3;
  --bg-sunken:  #E9E1D2;
  --surface:    #FFFFFF;
  --surface-2:  #FAF7F1;

  --fg:    #1C1812;
  --fg-2:  #4A4338;
  --fg-3:  #80776A;
  --fg-4:  #B0A797;

  --border:        rgba(28, 24, 18, 0.10);
  --border-strong: rgba(28, 24, 18, 0.20);
  --border-subtle: rgba(28, 24, 18, 0.06);

  --brand:        var(--pine-500);
  --brand-hover:  var(--pine-600);
  --brand-press:  var(--pine-700);
  --brand-soft:   var(--pine-50);
  --on-brand:     #FAF7F1;

  --accent:       var(--ember-400);
  --accent-hover: var(--ember-500);
  --accent-soft:  var(--ember-50);
  --on-accent:    #FAF7F1;

  --success: #2E6B43;
  --warning: #B47D1E;
  --danger:  #A6402C;
  --info:    var(--sky-400);

  --success-soft: #E5EFE8;
  --warning-soft: #F6ECD5;
  --danger-soft:  #F6E2DC;
  --info-soft:    #E3ECF1;

  /* sand-tinted "soft" + readable on-color, used by the PATCH badge */
  --sand-soft: #F6EFE3;
  --sand-on:   #8A3F1E; /* ember-600 reads well on sand-soft */

  /* Card elevation — soft warm shadow on light, deeper on dark */
  --shadow-card:       0 1px 2px rgba(28, 24, 18, 0.05);
  --shadow-card-hover: 0 4px 12px -2px rgba(28, 24, 18, 0.08), 0 2px 4px -1px rgba(28, 24, 18, 0.04);

  --focus-ring: 0 0 0 3px rgba(75, 125, 88, 0.35);

  /* Legacy aliases — original graphsdk-site rules use these names */
  --color-bg:          var(--bg);
  --color-fg:          var(--fg);
  --color-muted:       var(--bg-soft);
  --color-muted-fg:    var(--fg-3);
  --color-border:      var(--border-strong);
  --color-link:        var(--brand);
  --color-link-hover:  var(--brand-hover);
  --color-accent:      var(--brand-soft);
  --color-accent-fg:   var(--brand);
  --color-panel:       var(--surface);
  --color-code-bg:     var(--bg-soft);
  --color-code-border: var(--border);
  --color-focus:       var(--accent);
  --color-danger:      var(--danger);
  --color-danger-bg:   rgba(166, 64, 44, 0.10);
}

/* Pastel */
[data-theme="pastel"] {
  --bg:         #F4F1E8;
  --bg-soft:    #EAE6D8;
  --bg-sunken:  #DFD9C5;
  --surface:    #FBF9F2;
  --surface-2:  #F4F1E8;

  --fg:    #2B2A24;
  --fg-2:  #5C5849;
  --fg-3:  #8C8773;
  --fg-4:  #B8B19A;

  --border:        rgba(43, 42, 36, 0.10);
  --border-strong: rgba(43, 42, 36, 0.20);
  --border-subtle: rgba(43, 42, 36, 0.06);

  --brand:        #6E9A78;
  --brand-hover:  #5C8466;
  --brand-press:  #4B6E54;
  --brand-soft:   #DDE8DE;
  --on-brand:     #FBF9F2;

  --accent:       #E5A07A;
  --accent-hover: #D38961;
  --accent-soft:  #F6E3D5;
  --on-accent:    #2B2A24;

  --success: #6E9A78;
  --warning: #C9A55E;
  --danger:  #C47660;
  --info:    #8FAEBC;

  --success-soft: #DDE8DE;
  --warning-soft: #EFE4C9;
  --danger-soft:  #F0DAD0;
  --info-soft:    #D9E4EA;

  --sand-soft: #ECDFC4;
  --sand-on:   #8A3F1E;

  --shadow-card:       0 1px 2px rgba(43, 42, 36, 0.05);
  --shadow-card-hover: 0 4px 12px -2px rgba(43, 42, 36, 0.08), 0 2px 4px -1px rgba(43, 42, 36, 0.04);

  --focus-ring: 0 0 0 3px rgba(110, 154, 120, 0.30);

  --color-bg:          var(--bg);
  --color-fg:          var(--fg);
  --color-muted:       var(--bg-soft);
  --color-muted-fg:    var(--fg-3);
  --color-border:      var(--border-strong);
  --color-link:        var(--brand);
  --color-link-hover:  var(--brand-hover);
  --color-accent:      var(--brand-soft);
  --color-accent-fg:   var(--brand);
  --color-panel:       var(--surface);
  --color-code-bg:     var(--bg-soft);
  --color-code-border: var(--border);
  --color-focus:       var(--accent);
  --color-danger:      var(--danger);
  --color-danger-bg:   rgba(196, 118, 96, 0.18);
}

/* Dark */
[data-theme="dark"] {
  --bg:         #14171B;
  --bg-soft:    #1A1E23;
  --bg-sunken:  #0F1216;
  --surface:    #1E2329;
  --surface-2:  #262C33;

  --fg:    #F0EBE0;
  --fg-2:  #C5BFB1;
  --fg-3:  #8E8676;
  --fg-4:  #5C5749;

  --border:        rgba(240, 235, 224, 0.10);
  --border-strong: rgba(240, 235, 224, 0.20);
  --border-subtle: rgba(240, 235, 224, 0.05);

  --brand:        #7AB58C;
  --brand-hover:  #98C8A6;
  --brand-press:  #B6DBC1;
  --brand-soft:   rgba(122, 181, 140, 0.14);
  --on-brand:     #14171B;

  --accent:       #E58F61;
  --accent-hover: #EFA882;
  --accent-soft:  rgba(229, 143, 97, 0.14);
  --on-accent:    #14171B;

  --success: #7AB58C;
  --warning: #E3BD6A;
  --danger:  #E08572;
  --info:    #8FB8CC;

  --success-soft: rgba(122, 181, 140, 0.14);
  --warning-soft: rgba(227, 189, 106, 0.14);
  --danger-soft:  rgba(224, 133, 114, 0.14);
  --info-soft:    rgba(143, 184, 204, 0.14);

  --sand-soft: rgba(199, 169, 114, 0.16);
  --sand-on:   #E58F61; /* ember-300, lifted for contrast on alpine night */

  --shadow-card:       0 1px 2px rgba(0, 0, 0, 0.30);
  --shadow-card-hover: 0 4px 12px -2px rgba(0, 0, 0, 0.40), 0 2px 4px -1px rgba(0, 0, 0, 0.25);

  --focus-ring: 0 0 0 3px rgba(122, 181, 140, 0.40);

  --color-bg:          var(--bg);
  --color-fg:          var(--fg);
  --color-muted:       var(--bg-soft);
  --color-muted-fg:    var(--fg-3);
  --color-border:      var(--border-strong);
  --color-link:        var(--brand);
  --color-link-hover:  var(--brand-hover);
  --color-accent:      var(--brand-soft);
  --color-accent-fg:   var(--brand);
  --color-panel:       var(--surface);
  --color-code-bg:     var(--bg-soft);
  --color-code-border: var(--border);
  --color-focus:       var(--accent);
  --color-danger:      var(--danger);
  --color-danger-bg:   rgba(224, 133, 114, 0.18);
}

* {
  box-sizing: border-box;
}

html { height: 100%; }

body {
  margin: 0;
  min-height: 100%;
  padding-top: var(--header-height); /* room for the fixed header */
  font-family: var(--font-sans);
  font-size: var(--fs-base);
  line-height: 1.6;
  color: var(--fg);
  background: var(--bg);
  -webkit-font-smoothing: antialiased;
  text-rendering: optimizeLegibility;
}

/* Content typography — display serif for editorial headings, sans for UI. */
h1, .t-h1 {
  font-family: var(--font-display);
  font-weight: 400;
  font-size: var(--fs-3xl);
  line-height: 1.1;
  letter-spacing: -0.02em;
  color: var(--fg);
  margin: 0 0 var(--sp-4);
}

h2, .t-h2 {
  font-family: var(--font-display);
  font-weight: 400;
  font-size: var(--fs-2xl);
  line-height: 1.2;
  letter-spacing: -0.02em;
  color: var(--fg);
  margin: 0 0 var(--sp-3);
}

h3, .t-h3 {
  font-family: var(--font-sans);
  font-weight: 600;
  font-size: var(--fs-xl);
  line-height: 1.3;
  letter-spacing: -0.01em;
  color: var(--fg);
  margin: 0 0 var(--sp-3);
}

h4, .t-h4 {
  font-family: var(--font-sans);
  font-weight: 500;
  font-size: var(--fs-lg);
  line-height: 1.3;
  color: var(--fg);
  margin: 0 0 var(--sp-2);
}

a {
  color: var(--brand);
  text-decoration: none;
}

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

img {
  max-width: 100%;
  height: auto;
}

button,
input,
select,
textarea {
  font: inherit;
}

button {
  border: 1px solid var(--color-border);
  background: var(--color-panel);
  color: var(--color-fg);
  padding: 4px 10px;
  border-radius: 2px;
  cursor: pointer;
}

button:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible {
  outline: 2px solid var(--color-focus);
  outline-offset: 2px;
}

input,
select,
textarea {
  border: 1px solid var(--color-border);
  background: var(--color-panel);
  color: var(--color-fg);
  padding: 6px 8px;
  border-radius: 2px;
}

pre,
code {
  font-family: var(--font-mono);
}

pre {
  background: var(--color-code-bg);
  border: 1px solid var(--color-code-border);
  padding: 12px;
  overflow-x: auto;
  margin: 0;
}

code {
  background: var(--color-code-bg);
  padding: 0 4px;
  border-radius: 2px;
}

.hidden {
  display: none !important;
}

.muted {
  color: var(--color-muted-fg);
}

.mono {
  font-family: var(--font-mono);
}

.small {
  font-size: 12px;
}

.app-shell {
  min-height: 100vh;
  display: flex;
  flex-direction: column;
}

.docs-header {
  position: fixed;
  top: 0;
  left: 0;
  right: 0;
  z-index: 30;
  height: var(--header-height);
  background: var(--bg);
  border-bottom: 3px solid var(--accent);
}

.docs-header-inner {
  max-width: 1200px;
  margin: 0 auto;
  height: 100%;
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  padding: 0 16px;
}

.docs-header-left {
  display: flex;
  align-items: center;
  gap: 10px;
}

.docs-title {
  font-family: var(--font-display);
  font-size: var(--fs-lg);
  font-weight: 400;
  color: var(--fg);
  margin: 0;
}

.docs-actions {
  display: flex;
  align-items: center;
  gap: 8px;
}

/* North7 brand — header lockup + footer mark.
   Both SVGs use the "pure" (currentColor) variant so they adapt to theme fg. */
.docs-brand {
  display: inline-flex;
  align-items: center;
  color: var(--brand);
  text-decoration: none;
  line-height: 0;
}

.docs-brand-lockup {
  height: 36px;
  width: auto;
  display: block;
}

/* Two lockup variants: --light is the currentColor "pure" SVG used on light/pastel
   themes; --dark is the "night" SVG with baked-in alpine-night bg and medium pine,
   used on dark theme so the lockup sits seamlessly against the page bg. */
.docs-brand-lockup--dark { display: none; }
[data-theme="dark"] .docs-brand-lockup--light { display: none; }
[data-theme="dark"] .docs-brand-lockup--dark  { display: block; }

.docs-brand-divider {
  width: 1px;
  height: 24px;
  background: var(--border-strong);
  margin: 0 var(--sp-2);
  flex: 0 0 auto;
}

.docs-footer-brand {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-3);
  color: var(--fg-2);
}

.docs-footer-mark {
  height: 22px;
  width: 22px;
  display: block;
  color: var(--brand);
}

.docs-body {
  display: grid;
  grid-template-columns: var(--nav-width) minmax(0, 1fr);
  gap: 0;
  min-height: calc(100vh - var(--header-height));
}

.docs-body.with-toc {
  grid-template-columns: var(--nav-width) minmax(0, 1fr) var(--toc-width);
}

.docs-nav {
  border-right: 1px solid var(--border-subtle);
  background: var(--bg-soft);
  padding: var(--sp-4) var(--sp-3);
  position: sticky;
  top: var(--header-height);
  height: calc(100vh - var(--header-height));
  overflow: auto;
}

.docs-toc {
  border-left: 1px solid var(--border-subtle);
  padding: var(--sp-4) var(--sp-3);
  background: var(--bg-soft);
  position: sticky;
  top: var(--header-height);
  height: calc(100vh - var(--header-height));
  overflow: auto;
}

.docs-toc:empty {
  display: none;
}

.docs-content {
  padding: var(--page-padding) 32px 48px;
  min-width: 0;
}

.doc-section {
  max-width: var(--content-max);
  margin: 0 auto 24px;
}

.doc-page-header {
  display: flex;
  align-items: flex-start;
  justify-content: space-between;
  gap: 16px;
  border-bottom: 1px solid var(--color-border);
  padding-bottom: 12px;
}

.doc-category {
  border-bottom: 1px solid var(--color-border);
  padding: 12px 0;
}

.doc-category-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 12px;
  cursor: pointer;
}

.doc-category-title {
  font-weight: 600;
}

.doc-category-meta {
  color: var(--color-muted-fg);
  font-size: 12px;
}

.doc-category-body {
  padding-top: 8px;
}

.no-results-message {
  padding: 12px 0;
}

.doc-title {
  font-family: var(--font-display);
  font-size: var(--fs-3xl);
  font-weight: 400;
  letter-spacing: -0.02em;
  line-height: 1.1;
  color: var(--fg);
  margin: 0 0 var(--sp-2);
}

.doc-subtitle {
  font-family: var(--font-sans);
  font-size: var(--fs-md);
  font-weight: 300;
  line-height: 1.5;
  color: var(--fg-2);
  margin: 0 0 var(--sp-4);
}

.doc-meta {
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  color: var(--fg-3);
}

/* Eyebrow — small uppercase label above content blocks */
.section-title {
  font-family: var(--font-sans);
  font-size: var(--fs-xs);
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.18em;
  color: var(--fg-3);
  margin: 0 0 var(--sp-3);
}

.doc-actions {
  display: flex;
  gap: 8px;
  align-items: center;
}

.doc-list {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-direction: column;
  gap: var(--sp-2);
}

/* Card surface for repeated items (endpoints, cmdlets, permissions).
   Sits on --surface against the --bg page, per DESIGN.md §4 card guidance. */
.doc-list-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--sp-4);
  padding: var(--sp-4) var(--sp-5);
  background: var(--surface);
  border: 1px solid var(--border-subtle);
  border-radius: var(--r-lg);
  box-shadow: var(--shadow-card);
  transition:
    border-color var(--t-fast) var(--ease-out),
    background var(--t-fast) var(--ease-out),
    box-shadow var(--t-fast) var(--ease-out),
    transform var(--t-fast) var(--ease-out);
}

.doc-list-item.is-clickable {
  cursor: pointer;
}

.doc-list-item.is-clickable:hover {
  border-color: var(--border-strong);
  box-shadow: var(--shadow-card-hover);
  transform: translateY(-1px);
}

.doc-list-item.is-selected {
  border-color: var(--brand);
  background: var(--brand-soft);
  box-shadow: var(--shadow-card-hover);
}

.doc-list-item-content {
  display: flex;
  gap: var(--sp-3);
  align-items: flex-start;
  min-width: 0;
  width: 100%;
}

.doc-list-item-text {
  min-width: 0;
}

.doc-list-item-badges {
  display: flex;
  flex-wrap: wrap;
  gap: 4px;
}

.doc-list-item-title {
  font-family: var(--font-mono);
  font-size: var(--fs-sm);
  font-weight: 500;
  color: var(--fg);
  margin: 0;
  word-break: break-all;
}

.doc-list-item-desc {
  font-family: var(--font-sans);
  font-size: var(--fs-sm);
  color: var(--fg-3);
  margin: var(--sp-2) 0 0;
  line-height: 1.5;
}

.loading-spinner {
  display: inline-block;
  width: 14px;
  height: 14px;
  border: 2px solid var(--color-border);
  border-top-color: var(--color-link);
  border-radius: 50%;
  margin-right: 6px;
  vertical-align: text-bottom;
}

.result-item {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  padding: 6px 0;
  border-bottom: 1px solid var(--color-border);
  cursor: pointer;
}

.result-item:last-child {
  border-bottom: 0;
}

.result-item.is-selected,
.result-item:hover {
  background: var(--color-accent);
}

.result-item-title {
  font-size: 12px;
}

.badge {
  display: inline-flex;
  align-items: center;
  border: 1px solid var(--color-border);
  background: var(--color-muted);
  color: var(--color-fg);
  font-size: 11px;
  padding: 1px 6px;
  border-radius: 2px;
  white-space: nowrap;
}

.badge + .badge {
  margin-left: 4px;
}

/* Method badges — mapped to North7 semantic tokens.
   GET → info (sky). POST → success (pine).
   PUT → warning (amber). PATCH → sand (warm tan, no purple in palette).
   DELETE → danger. */
.badge.method-get {
  border-color: var(--info);
  color: var(--info);
  background: var(--info-soft);
}

.badge.method-post {
  border-color: var(--success);
  color: var(--success);
  background: var(--success-soft);
}

.badge.method-put {
  border-color: var(--warning);
  color: var(--warning);
  background: var(--warning-soft);
}

.badge.method-patch {
  border-color: var(--sand-300);
  color: var(--sand-on);
  background: var(--sand-soft);
}

.badge.method-delete {
  border-color: var(--danger);
  color: var(--danger);
  background: var(--danger-soft);
}

/* Permission badges — App is elevated/distinct (accent ember), Delegated is the common case (success). */
.badge.permission-app {
  border-color: var(--accent);
  color: var(--accent-hover);
  background: var(--accent-soft);
}

.badge.permission-delegated {
  border-color: var(--success);
  color: var(--success);
  background: var(--success-soft);
}

.perm-type-icon {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 16px;
  height: 16px;
  color: var(--color-muted-fg);
}

.perm-type-icon svg {
  width: 14px;
  height: 14px;
}

.perm-type-icon + .perm-type-icon {
  margin-left: 4px;
}

.perm-type-badge {
  display: inline-flex;
  align-items: center;
  gap: 4px;
  font-size: 11px;
  color: var(--color-muted-fg);
}

.perm-type-label {
  color: var(--color-fg);
}

.operation-indicator {
  display: inline-flex;
  align-items: center;
  border: 1px solid var(--color-border);
  color: var(--color-muted-fg);
  font-size: 10px;
  padding: 0 4px;
  border-radius: 2px;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  margin-left: 6px;
}

.table {
  width: 100%;
  border-collapse: collapse;
  font-size: 13px;
}

.table th,
.table td {
  text-align: left;
  padding: 6px 8px;
  border-bottom: 1px solid var(--color-border);
}

.table th {
  font-weight: 600;
  background: var(--color-muted);
}

.table-wrap {
  overflow-x: auto;
}

.tabs {
  border-bottom: 1px solid var(--color-border);
  display: flex;
  gap: 8px;
  flex-wrap: wrap;
}

.tab-button {
  border: none;
  background: none;
  padding: 8px 2px;
  color: var(--color-muted-fg);
  cursor: pointer;
  text-decoration: none;
  display: inline-flex;
  align-items: center;
}

.tab-button.is-active {
  color: var(--color-fg);
  border-bottom: 2px solid var(--color-fg);
}

.tab-button:hover {
  color: var(--color-fg);
  text-decoration: none;
}

.tab-panel {
  padding: 16px 0;
  scroll-margin-top: calc(var(--header-height) + 12px);
}

.method-section {
  border-top: 1px solid var(--color-border);
  padding-top: 16px;
  margin-top: 16px;
  scroll-margin-top: calc(var(--header-height) + 12px);
}

.method-group {
  border-top: 1px solid var(--color-border);
  padding-top: 12px;
  margin-top: 12px;
}

.method-group:first-child {
  border-top: 0;
  padding-top: 0;
  margin-top: 0;
}

.method-header {
  display: flex;
  align-items: center;
  gap: 8px;
  margin-bottom: 8px;
}

.sidebar-section {
  padding: var(--sp-5) 0;
  border-bottom: 1px solid var(--border-subtle);
}

.sidebar-section:first-child {
  padding-top: var(--sp-3);
}

.sidebar-section:last-child {
  border-bottom: 0;
}

/* Sidebar section labels — North7 eyebrow */
.sidebar-title {
  font-family: var(--font-sans);
  font-size: var(--fs-xs);
  font-weight: 500;
  text-transform: uppercase;
  letter-spacing: 0.18em;
  color: var(--fg-3);
  margin-bottom: var(--sp-3);
  padding: 0 var(--sp-2);
}

.sidebar-list {
  list-style: none;
  padding: 0;
  margin: 0;
  display: flex;
  flex-direction: column;
  gap: 2px;
}

.sidebar-item {
  display: flex;
  align-items: center;
  gap: var(--sp-3);
  padding: var(--sp-3) var(--sp-3);
  border-radius: var(--r-md);
  cursor: pointer;
  font-family: var(--font-sans);
  font-size: var(--fs-sm);
  font-weight: 500;
  color: var(--fg-2);
  transition:
    background var(--t-fast) var(--ease-out),
    color var(--t-fast) var(--ease-out);
}

.sidebar-item:hover {
  background: var(--bg-sunken);
  color: var(--fg);
}

.sidebar-item.is-active {
  background: var(--brand-soft);
  color: var(--brand);
}

.sidebar-item-icon {
  width: 18px;
  height: 18px;
  flex-shrink: 0;
  color: var(--fg-3);
  transition: color var(--t-fast) var(--ease-out);
}

.sidebar-item:hover .sidebar-item-icon,
.sidebar-item.is-active .sidebar-item-icon {
  color: currentColor;
}

/* Dynamic lists (categories, items) — no SVG icon, so add a dot bullet for visual rhythm */
#categories-list .sidebar-item,
#navigation-items .sidebar-item {
  font-weight: 400;
  padding-left: var(--sp-3);
}

#categories-list .sidebar-item::before,
#navigation-items .sidebar-item::before {
  content: '';
  display: inline-block;
  width: 4px;
  height: 4px;
  border-radius: 50%;
  background: var(--fg-4);
  flex-shrink: 0;
  transition: background var(--t-fast) var(--ease-out);
}

#categories-list .sidebar-item:hover::before,
#navigation-items .sidebar-item:hover::before {
  background: var(--fg-3);
}

#categories-list .sidebar-item.is-active::before,
#navigation-items .sidebar-item.is-active::before {
  background: var(--brand);
}

/* Segmented version toggle — inset on bg-sunken, active button on surface */
.version-toggle {
  display: flex;
  gap: 2px;
  background: var(--bg-sunken);
  padding: 3px;
  border-radius: var(--r-md);
}

.version-button {
  flex: 1;
  border: 0;
  background: transparent;
  text-align: center;
  padding: var(--sp-2) var(--sp-3);
  border-radius: var(--r-sm);
  font-family: var(--font-sans);
  font-size: var(--fs-sm);
  font-weight: 500;
  color: var(--fg-2);
  cursor: pointer;
  transition:
    background var(--t-fast) var(--ease-out),
    color var(--t-fast) var(--ease-out);
}

.version-button:hover {
  color: var(--fg);
}

.version-button.is-active {
  background: var(--surface);
  color: var(--brand);
}

.sidebar-search {
  position: relative;
}

.sidebar-search-icon {
  position: absolute;
  left: var(--sp-3);
  top: 50%;
  transform: translateY(-50%);
  width: 14px;
  height: 14px;
  color: var(--fg-3);
  pointer-events: none;
}

.sidebar-search-input {
  width: 100%;
  border: 1px solid var(--border-strong);
  background: var(--surface);
  color: var(--fg);
  padding: var(--sp-2) var(--sp-3) var(--sp-2) calc(var(--sp-3) + 20px);
  border-radius: var(--r-md);
  font-family: var(--font-sans);
  font-size: var(--fs-sm);
}

.docs-footer {
  border-top: 3px solid var(--accent);
  background: var(--bg);
  padding: var(--sp-3) var(--sp-4);
  margin-top: auto;
  min-height: var(--footer-height);
  display: flex;
  align-items: center;
}

.footer-inner {
  max-width: 1200px;
  margin: 0 auto;
  display: flex;
  flex-wrap: wrap;
  gap: 8px 16px;
  justify-content: space-between;
  align-items: center;
}

.button-link {
  border: none;
  background: none;
  padding: 0;
  color: var(--color-link);
  cursor: pointer;
  display: inline-flex;
  align-items: center;
  gap: 6px;
}

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

.icon {
  width: 14px;
  height: 14px;
  flex: 0 0 auto;
  color: currentColor;
}

/* Back-to-list button — ghost button with left chevron, used on detail pages. */
#back-to-list {
  display: inline-flex;
  align-items: center;
  gap: var(--sp-2);
  padding: var(--sp-2) var(--sp-4);
  font-family: var(--font-sans);
  font-size: var(--fs-sm);
  font-weight: 500;
  color: var(--fg-2);
  background: transparent;
  border: 1px solid var(--border-strong);
  border-radius: var(--r-md);
  cursor: pointer;
  white-space: nowrap;
  transition:
    color var(--t-fast) var(--ease-out),
    border-color var(--t-fast) var(--ease-out),
    background var(--t-fast) var(--ease-out);
}

#back-to-list:hover {
  color: var(--fg);
  border-color: var(--fg-3);
  background: var(--bg-soft);
}

#back-to-list::before {
  content: '';
  display: inline-block;
  width: 16px;
  height: 16px;
  background-color: currentColor;
  flex-shrink: 0;
  -webkit-mask: url("data:image/svg+xml;utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='1.75' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M19 12H5M11 5l-7 7 7 7'/%3E%3C/svg%3E") no-repeat center / contain;
          mask: url("data:image/svg+xml;utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='black' stroke-width='1.75' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpath d='M19 12H5M11 5l-7 7 7 7'/%3E%3C/svg%3E") no-repeat center / contain;
}

/* Icon-cycle theme switcher — single button, shows the icon matching the current theme.
   Cycles light → dark → pastel → light on click. Per DESIGN.md §6 UI shape. */
.theme-cycle {
  display: inline-flex;
  align-items: center;
  justify-content: center;
  width: 36px;
  height: 36px;
  padding: 0;
  border: 1px solid var(--border-strong);
  background: transparent;
  color: var(--fg-2);
  border-radius: var(--r-md);
  cursor: pointer;
  transition:
    color var(--t-fast) var(--ease-out),
    border-color var(--t-fast) var(--ease-out),
    background var(--t-fast) var(--ease-out);
}

.theme-cycle:hover {
  color: var(--fg);
  border-color: var(--fg-3);
  background: var(--bg-soft);
}

.theme-cycle .theme-icon {
  width: 18px;
  height: 18px;
  display: none;
}

[data-theme="light"]  .theme-cycle .theme-icon[data-theme-icon="light"],
[data-theme="dark"]   .theme-cycle .theme-icon[data-theme-icon="dark"],
[data-theme="pastel"] .theme-cycle .theme-icon[data-theme-icon="pastel"] {
  display: block;
}

.modal-search-input {
  width: 100%;
  margin: 8px 0;
}

.filter-bar {
  display: flex;
  flex-wrap: wrap;
  gap: 6px;
  margin: 8px 0 12px;
}

.filter-button {
  border: 1px solid var(--color-border);
  background: var(--color-muted);
  color: var(--color-fg);
  padding: 2px 8px;
  border-radius: 2px;
  cursor: pointer;
  font-size: 12px;
}

.filter-button.is-active {
  background: var(--color-accent);
  color: var(--color-accent-fg);
}

.search-section {
  margin-top: 12px;
}

.search-section-header {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: 8px;
  margin-bottom: 6px;
}

.search-section-meta {
  display: flex;
  align-items: center;
  gap: 8px;
}

.modal-footer {
  display: flex;
  justify-content: space-between;
  align-items: center;
  margin-top: 12px;
  border-top: 1px solid var(--color-border);
  padding-top: 8px;
}

.alert {
  border: 1px solid var(--color-border);
  background: var(--color-muted);
  padding: 12px;
  border-radius: 2px;
}

.alert-error {
  border-color: var(--color-danger);
  background: var(--color-danger-bg);
  color: var(--color-danger);
}

.alert-actions {
  margin-top: 8px;
}

#sidebar-toggle {
  display: none;
}

@media (max-width: 1100px) {
  .docs-body {
    grid-template-columns: var(--nav-width) minmax(0, 1fr);
  }

  .docs-toc {
    display: none;
  }
}

@media (max-width: 880px) {
  .docs-body {
    grid-template-columns: minmax(0, 1fr);
  }

  .docs-nav {
    position: fixed;
    left: 0;
    top: var(--header-height);
    height: calc(100vh - var(--header-height));
    width: var(--nav-width);
    z-index: 40;
    display: none;
    border-right: 1px solid var(--color-border);
  }

  .docs-nav.sidebar-visible {
    display: block;
  }

  .docs-content {
    padding: 16px;
  }

  .docs-header-inner {
    padding: 0 12px;
  }

  #sidebar-toggle {
    display: inline;
  }

  .doc-page-header {
    flex-direction: column;
    align-items: flex-start;
  }
}
