/* ============================================================
   Swa — mtindo wa tovuti
   ------------------------------------------------------------
   Utambulisho: "mlango uliochongwa" — milango ya mninga ya
   Zanzibar. Mandhari ya mwanga ni ukuta wa chokaa wa asubuhi;
   mandhari ya giza ni mlango usiku. Shaba ni accent, bahari ni
   rangi ya pili, na nyota ya pembe nane ndiyo pambo pekee.
   Maelezo kamili ya muundo: /tmp/swa-tovuti-kazi/mwelekeo-wa-muundo.md
   ============================================================ */

/* ------------------------------------------------------------
   1a. Tokens za mandhari ya mwanga (chaguo-msingi)
   ------------------------------------------------------------ */
:root {
  color-scheme: light;

  /* Mfuko na gridi */
  --container: 70rem;
  --container-narrow: 45rem;

  /* Familia za fonti (mistari ya kuhifadhi) */
  --font-sans:    "IBM Plex Sans", system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif;
  --font-display: "Fraunces", "Iowan Old Style", "Palatino Linotype", "Book Antiqua", Georgia, serif;
  --font-mono:    "IBM Plex Mono", ui-monospace, "SF Mono", "Cascadia Mono", "JetBrains Mono", Menlo, Consolas, "Liberation Mono", monospace;

  /* Kiwango cha ukubwa (uwiano 1.25) */
  --fs-xs:  0.75rem;   /* tarehe, lebo za kando */
  --fs-sm:  0.875rem;  /* vichwa vya kolamu, jina la faili, mawimbi ya terminal */
  --fs-base: 1rem;     /* maandishi ya msingi */
  --fs-md:  1.125rem;  /* lede, kichwa cha kadi, vitufe vikubwa */
  --fs-1:   1.25rem;   /* kichwa cha h3 (ndani ya prose) */
  --fs-2:   1.5625rem; /* kichwa cha h3 maalum, kauli */
  --fs-3:   1.953rem;  /* kichwa cha h2 cha sehemu */
  --fs-4:   2.441rem;  /* kichwa cha h1 cha kurasa ndogo */
  --fs-5:   3.052rem;  /* kichwa cha hero (kikubwa) */
  --fs-6:   3.815rem;  /* kichwa cha hero (kikubwa zaidi, 1200px+) */

  /* Kiwango cha nafasi */
  --space-1: 0.25rem;
  --space-2: 0.5rem;
  --space-3: 0.75rem;
  --space-4: 1rem;
  --space-5: 1.5rem;
  --space-6: 2rem;
  --space-7: 3rem;
  --space-8: 4rem;
  --space-9: 6rem;

  /* Rangi za msingi */
  --bg:              #FAF7EF;  /* ukuta wa chokaa */
  --bg-alt:          #F2ECDF;  /* kivuli cha chokaa */
  --surface:         #FFFFFF;  /* uso wa kadi */
  --ink:             #26201A;  /* mninga */
  --muted:           #6E6252;  /* mchanga mweusi */
  --faint:           #766A51;  /* mchanga mweusi zaidi (lebo, tarehe) */
  --accent:          #A34E14;  /* shaba (viungo, vitufe) */
  --accent-strong:   #7E3A0C;  /* shaba iliyokolea (hover) */
  --accent-soft:     #F6E6D3;  /* chip ya accent (kipengele kinachotumika) */
  --ocean:           #1D4E77;  /* bahari (accent ya pili) */
  --ocean-soft:      #E9F1F8;  /* callout ya maelezo */
  --kijani-soft:     #EBF2E5;  /* callout ya kidokezo */
  --btn-text:        #FFFDF6;  /* maandishi kwenye vitufe vya shaba */
  --border:          #E4DBC6;  /* mpaka wa mapambo (1px) */
  --border-strong:   #9B8D6E;  /* mpaka wa vipengele vya UI */
  --inline-code-bg:  #F2ECDF;
  --inline-code-ink: #7E3A0C;
  --focus-outline:   #A34E14;

  /* Kisima cha msimbo = bendi ya usiku */
  --code-bg:         #161009;  /* mninga giza */
  --code-ink:        #F0E8D6;  /* mwanga wa mbao */
  --code-muted:      #9C9080;  /* jina la faili, mwongozo */
  --code-link:       #F2B45C;  /* shaba angavu: viungo kwenye bendi, neno muhimu */
  --code-link-hover: #E8A070;
  --code-border:     #3A3120;  /* mpaka wa mapambo ndani ya kisima */

  /* Sintaksia (kwenye --code-bg) */
  --syn-kw:   #F2B45C;  /* neno muhimu */
  --syn-type: #7DB4E6;  /* aina */
  --syn-fn:   #E8A070;  /* kazi */
  --syn-str:  #A9C97F;  /* mfuatano */
  --syn-num:  #E8B64D;  /* nambari */
  --syn-com:  #9C9080;  /* maoni */

  /* Rangi za ziada za callouts (zilizopimwa katika 3.5) */
  --kijani:             #3E5C2E;  /* mpaka wa callout ya kidokezo */
  --accent-soft-callout: #FBEBDD; /* usuli wa callout ya tahadhari */
}

/* ------------------------------------------------------------
   1b. Mandhari ya giza kutoka kwa mfumo (bila JS, bila uchaguzi)
       — mlango wa mninga usiku. Mtumiaji aliyechagua "mwanga"
       kwa uwazi huzuia block hii.
   ------------------------------------------------------------ */
@media (prefers-color-scheme: dark) {
  :root:not([data-mandhari="mwanga"]) {
    color-scheme: dark;

    --bg:              #16110A;  /* mninga usiku */
    --bg-alt:          #1D1710;
    --surface:         #221B12;
    --ink:             #F1E9D6;  /* mwanga wa mbao */
    --muted:           #B7AC97;
    --faint:           #9C8F7E;
    --accent:          #E3A04B;  /* shaba angavu */
    --accent-strong:   #C98532;
    --accent-soft:     #3A2B17;
    --ocean:           #7FB8E8;  /* bahari ya usiku */
    --ocean-soft:      #16222E;
    --kijani-soft:     #1A2417;
    --btn-text:        #1A140B;
    --border:          #33291B;
    --border-strong:   #76674E;
    --inline-code-bg:  #2A2113;
    --inline-code-ink: #E3A04B;
    --focus-outline:   #E3A04B;

    --code-bg:         #0D0905;
    --code-ink:        #F2EAD8;
    --code-muted:      #A79A88;
    --code-link:       #F4BA63;
    --code-link-hover: #EC9E6E;
    --code-border:     #2E2414;

    --syn-kw:   #F4BA63;
    --syn-type: #83BCEF;
    --syn-fn:   #EC9E6E;
    --syn-str:  #B2D389;
    --syn-num:  #ECC05E;
    --syn-com:  #A79A88;

    --kijani:              #A9C97F;
    --accent-soft-callout: #2E2417;
  }

  /* Marekebisho ya vipengele kwa giza (nguvu zaidi ya mistari ya chini) */
  :root:not([data-mandhari="mwanga"]) .site-footer { background: var(--bg); }
  :root:not([data-mandhari="mwanga"]) .docs-link.active,
  :root:not([data-mandhari="mwanga"]) .docs-link[aria-current="location"] { color: var(--code-link); }
  :root:not([data-mandhari="mwanga"]) .callout-tahadhari .callout-title { color: var(--accent); }
}

/* ------------------------------------------------------------
   1c. Mandhari ya giza iliyochaguliwa na mtumiaji (inashinda
       kila kitu, pande zote mbili)
   ------------------------------------------------------------ */
:root[data-mandhari="giza"] {
  color-scheme: dark;

  --bg:              #16110A;
  --bg-alt:          #1D1710;
  --surface:         #221B12;
  --ink:             #F1E9D6;
  --muted:           #B7AC97;
  --faint:           #9C8F7E;
  --accent:          #E3A04B;
  --accent-strong:   #C98532;
  --accent-soft:     #3A2B17;
  --ocean:           #7FB8E8;
  --ocean-soft:      #16222E;
  --kijani-soft:     #1A2417;
  --btn-text:        #1A140B;
  --border:          #33291B;
  --border-strong:   #76674E;
  --inline-code-bg:  #2A2113;
  --inline-code-ink: #E3A04B;
  --focus-outline:   #E3A04B;

  --code-bg:         #0D0905;
  --code-ink:        #F2EAD8;
  --code-muted:      #A79A88;
  --code-link:       #F4BA63;
  --code-link-hover: #EC9E6E;
  --code-border:     #2E2414;

  --syn-kw:   #F4BA63;
  --syn-type: #83BCEF;
  --syn-fn:   #EC9E6E;
  --syn-str:  #B2D389;
  --syn-num:  #ECC05E;
  --syn-com:  #A79A88;

  --kijani:              #A9C97F;
  --accent-soft-callout: #2E2417;
}

:root[data-mandhari="giza"] .site-footer { background: var(--bg); }
:root[data-mandhari="giza"] .docs-link.active,
:root[data-mandhari="giza"] .docs-link[aria-current="location"] { color: var(--code-link); }
:root[data-mandhari="giza"] .callout-tahadhari .callout-title { color: var(--accent); }

/* ------------------------------------------------------------
   2. Msingi
   ------------------------------------------------------------ */
*,
*::before,
*::after { box-sizing: border-box; }

html {
  scroll-behavior: smooth;
  scroll-padding-top: 5rem;  /* kichwa kinachonata hakifichi vichwa vya ndani */
}

html,
body { overflow-x: clip; }  /* hakuna ukanda wa mlalo kwenye mwili kamwe */

body {
  margin: 0;
  background: var(--bg);
  color: var(--ink);
  font-family: var(--font-sans);
  font-size: var(--fs-base);
  line-height: 1.7;
  overflow-wrap: break-word;
}

h1, h2, h3, h4, h5, h6,
p, figure, blockquote, dl, dd { margin: 0; }

ul, ol { margin: 0; padding: 0; }

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

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

a {
  color: var(--accent);
  text-decoration: underline;
  text-underline-offset: 2px;
}

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

::selection {
  background: var(--accent-soft);
  color: var(--ink);
}

/* Mwelekeo unaoonekana kwa kibodi pekee */
a:focus-visible,
button:focus-visible,
input:focus-visible,
select:focus-visible,
textarea:focus-visible,
summary:focus-visible,
[tabindex]:not([tabindex="-1"]):focus-visible {
  outline: 2px solid var(--focus-outline);
  outline-offset: 2px;
}

/* Kiungo cha kuruka — kinaonekana kwa Shift+Tab ya kwanza */
.skip-link {
  position: absolute;
  left: 1rem;
  top: -100%;
  z-index: 100;
  background: var(--accent);
  color: var(--btn-text);
  padding: 0.5rem 1rem;
  border-radius: 0 0 6px 6px;
  font-weight: 600;
  text-decoration: none;
}
.skip-link:focus { top: 0; }

/* Kificho cha skrini pekee */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0 0 0 0);
  clip-path: inset(50%);
  white-space: nowrap;
  border: 0;
}

/* ------------------------------------------------------------
   3. Mfuko, gridi, mdundo wa sehemu
   ------------------------------------------------------------ */
.wrap,
.header-inner,
.footer-inner,
.footer-bottom {
  max-width: var(--container);
  margin-inline: auto;
  padding-inline: 1.5rem;
}

.container-narrow { max-width: var(--container-narrow); }

section.hero > .hero-grid:not(.wrap),
section > .split-grid:not(.wrap) {
  max-width: var(--container);
  margin-inline: auto;
  padding-inline: 1.5rem;
}

/* Mdundo wa sehemu: kubwa (96px) kwenye desktop, 48px chini yake */
.section,
.band { padding-block: var(--space-7); }

.section-alt {
  background: var(--bg-alt);
  padding-block: var(--space-6);  /* sehemu za pili: kompakt kidogo */
}

.section-head { margin-bottom: var(--space-6); }

.section-title {
  font-family: var(--font-display);
  font-weight: 500;
  font-size: var(--fs-3);
  line-height: 1.15;
  letter-spacing: -0.01em;
  margin: 0 0 var(--space-2);
}

.section-sub {
  color: var(--muted);
  font-size: var(--fs-md);
  line-height: 1.6;
  max-width: 55ch;
  margin: 0;
}

/* Bendi ya usiku (mnyororo wa kujikusanya) — ukuta wa kisima */
.band {
  background: var(--code-bg);
  color: var(--code-ink);
  border-top: 1px solid var(--code-border);
  border-bottom: 1px solid var(--code-border);
}
.band .section-title { color: var(--code-ink); }
.band .section-sub { color: var(--code-muted); }
.band a { color: var(--code-link); }
.band a:hover { color: var(--code-link-hover); }
.band :focus-visible,
.codeblock :focus-visible { outline-color: var(--code-link); }  /* shaba juu ya mbao */
.band .btn-primary {
  background: var(--code-link);
  color: var(--code-bg);
}
.band .btn-primary:hover {
  background: var(--code-link-hover);
  color: var(--code-bg);
}

/* ------------------------------------------------------------
   4. Kichwa na urambazaji
   ------------------------------------------------------------ */
.site-header {
  position: sticky;
  top: 0;
  z-index: 40;
  background: var(--bg);
  border-bottom: 1px solid var(--border);
}

.header-inner {
  display: flex;
  align-items: center;
  justify-content: space-between;
  gap: var(--space-4);
  padding-block: 0.75rem;  /* urefu wa kichwa: 64px */
}

/* Nembo: alama + "swa" */
.logo {
  display: inline-flex;
  align-items: center;
  gap: 0.5rem;
  font-family: var(--font-display);
  font-weight: 700;
  font-size: 1.35rem;
  letter-spacing: -0.02em;
  line-height: 1;
  color: var(--ink);
  text-decoration: none;
}
.logo-mark {
  width: 1.5rem;
  height: 1.5rem;
  flex-shrink: 0;
}

/* Urambazaji */
.nav-toggle {
  display: none;
  font-family: var(--font-mono);
  font-size: var(--fs-sm);
  color: var(--muted);
  background: none;
  border: 1px solid var(--border-strong);
  border-radius: 6px;
  padding: 0.375rem 0.75rem;
  cursor: pointer;
  line-height: 1.4;
}
.nav-toggle:hover { color: var(--accent); border-color: var(--accent); }

.nav-list {
  display: flex;
  align-items: center;
  gap: var(--space-5);
  list-style: none;
}

.nav-link {
  color: var(--muted);
  text-decoration: none;
  font-size: 0.9375rem;
  font-weight: 500;
  line-height: 1.4;
  padding: 0.25rem 0.125rem;
  border-radius: 4px;
}
.nav-link:hover { color: var(--ink); }
.nav-link.active,
.nav-link[aria-current="page"] {
  color: var(--ink);
  font-weight: 600;
}
.nav-link-msimbo { color: var(--accent); }
.nav-link-msimbo:hover { color: var(--accent-strong); }

/* Kitufe cha mandhari: maandishi yanaonyesha mandhari ya kwenda */
.theme-toggle {
  font-family: var(--font-mono);
  font-size: var(--fs-sm);
  color: var(--muted);
  background: none;
  border: 1px solid var(--border-strong);
  border-radius: 6px;
  padding: 0.375rem 0.75rem;
  cursor: pointer;
  line-height: 1.4;
  flex-shrink: 0;
}
.theme-toggle:hover { color: var(--accent); border-color: var(--accent); }

/* ------------------------------------------------------------
   5. Vitufe
   ------------------------------------------------------------ */
.btn {
  display: inline-block;
  padding: 0.6875rem 1.25rem;  /* 11px 20px */
  border-radius: 6px;
  font-family: var(--font-sans);
  font-weight: 600;
  font-size: 1rem;
  line-height: 1.4;
  text-decoration: none;
  border: 1px solid transparent;
  cursor: pointer;
  transition: background-color .2s ease, color .2s ease;
}
.btn-primary { background: var(--accent); color: var(--btn-text); }
.btn-primary:hover { background: var(--accent-strong); color: var(--btn-text); }
.btn:focus-visible {
  outline: 2px solid var(--focus-outline);
  outline-offset: 2px;
}
.btn:active { transform: translateY(1px); }
.btn:disabled { opacity: 0.5; cursor: default; }

/* Kiungo cha pili — maandishi tu, si kitufe cha pili chenye uzito sawa */
.kiungo-pembeni {
  display: inline-flex;
  align-items: center;
  gap: 0.4em;
  color: var(--ink);
  font-weight: 500;
  font-size: 1rem;
  text-decoration: none;
  border-bottom: 1px solid var(--border-strong);
  padding-bottom: 0.125rem;
  transition: color .2s ease, border-color .2s ease;
}
.kiungo-pembeni:hover { color: var(--accent); border-color: var(--accent); }

/* Eyebrow — lebo ndogo ya maandishi, si chip yenye mpaka */
.eyebrow {
  display: inline-flex;
  align-items: center;
  gap: 0.6rem;
  color: var(--accent);
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  font-weight: 600;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  text-decoration: none;
}
.eyebrow::before { content: ""; width: 1.375rem; height: 1px; background: currentColor; opacity: .55; }
.eyebrow:hover { color: var(--accent-strong); }
.hero .eyebrow { margin-bottom: var(--space-6); }

/* ------------------------------------------------------------
   6. Kisima cha msimbo
   ------------------------------------------------------------ */
.codeblock {
  position: relative;
  background: var(--code-bg);
  color: var(--code-ink);
  border-radius: 10px;
  font-family: var(--font-mono);
  font-size: 0.9375rem;  /* 15px — kubwa kuliko 13.8px ya zamani */
  line-height: 1.7;
  margin: 0;
  padding: 1.75rem 1.5rem 1.5rem;
  min-width: 0;
}

/* Jina la faili ni lebo tu juu ya msimbo, si upau wa dirisha */
.codeblock-bar {
  display: block;
  margin: 0 0 1rem;
  font-size: 0.8125rem;
  color: var(--code-muted);
}

/* Kitufe cha kunakili: kimefichwa hadi kishale kishike kisima —
   isipokuwa kwenye vifaa vya kugusa, ambavyo hakuna kishale */
.codeblock-copy {
  position: absolute;
  top: 1.25rem;
  right: 1.25rem;
  border: 1px solid var(--code-border);
  border-radius: 4px;
  background: color-mix(in srgb, var(--code-bg) 70%, black 8%);
  color: var(--code-muted);
  font-family: inherit;
  font-size: 0.8125rem;
  padding: 0.3rem 0.75rem;
  cursor: pointer;
  line-height: 1.4;
  transition: opacity .2s ease, border-color .2s ease, color .2s ease;
}
.codeblock-copy:hover,
.codeblock-copy:focus-visible { border-color: var(--code-link); color: var(--code-link); }
.codeblock-copy.imenakiliwa { border-color: var(--code-link); color: var(--code-link); }

@media (hover: hover) and (pointer: fine) {
  .codeblock-copy { opacity: 0; }
  .codeblock:hover .codeblock-copy,
  .codeblock:focus-within .codeblock-copy,
  .codeblock-copy:focus-visible,
  .codeblock-copy.imenakiliwa { opacity: 1; }
}

.codeblock pre {
  margin: 0;
  padding: 0;
  overflow-x: auto;
  tab-size: 4;
}

.codeblock-tokeo {
  margin-top: 1.25rem;
  padding-top: 1rem;
  border-top: 1px solid color-mix(in srgb, var(--code-ink) 12%, transparent);
  color: var(--code-ink);
  display: flex;
  gap: 1rem;
  flex-wrap: wrap;
}
.codeblock-prompt { color: var(--code-muted); }

/* Tokens za sintaksia (zote zimepimwa dhidi ya --code-bg) */
.tok-kw   { color: var(--syn-kw); }
.tok-type { color: var(--syn-type); }
.tok-fn   { color: var(--syn-fn); }
.tok-str  { color: var(--syn-str); }
.tok-num  { color: var(--syn-num); font-variant-numeric: tabular-nums; }
.tok-com  { color: var(--syn-com); font-style: italic; }

/* ------------------------------------------------------------
   7. Prose, msimbo wa ndani, callouts, majedwali
   ------------------------------------------------------------ */
.prose,
.docs-content { max-width: var(--container-narrow); min-width: 0; }

/* .docs-content hushiriki uchapaji ule ule — inaweza kutumika pekee
   au pamoja na .prose */
.prose h2,
.docs-content h2 {
  font-family: var(--font-display);
  font-weight: 500;
  font-size: var(--fs-3);
  line-height: 1.15;
  letter-spacing: -0.01em;
  margin: var(--space-7) 0 var(--space-4);
}
.prose h2:first-child,
.docs-content h2:first-child { margin-top: 0; }

.prose h3,
.docs-content h3 {
  font-size: var(--fs-1);
  font-weight: 600;
  line-height: 1.3;
  margin: var(--space-6) 0 var(--space-2);
}

.prose h4,
.docs-content h4 {
  font-size: var(--fs-base);
  font-weight: 600;
  line-height: 1.3;
  margin: var(--space-5) 0 var(--space-2);
}

.prose p,
.docs-content p {
  margin: 0 0 var(--space-4);
  line-height: 1.7;
}

.prose a,
.docs-content a {
  color: var(--accent);
  text-decoration: underline;
  text-underline-offset: 2px;
}
.prose a:hover,
.docs-content a:hover { color: var(--accent-strong); }

.prose strong,
.docs-content strong { font-weight: 600; }

.prose ul,
.prose ol,
.docs-content ul,
.docs-content ol {
  margin: 0 0 var(--space-4);
  padding-left: 1.375rem;
}
.prose li,
.docs-content li {
  margin-bottom: var(--space-2);
  line-height: 1.7;
}
.prose li:last-child,
.docs-content li:last-child { margin-bottom: 0; }

.prose hr,
.docs-content hr {
  margin: var(--space-6) 0;
  border: 0;
  border-top: 1px solid var(--border);
}

/* Msimbo wa ndani: toleo moja la rangi kwa mandhari yote */
.prose code:not(pre code),
.docs-content code:not(pre code) {
  background: var(--inline-code-bg);
  color: var(--inline-code-ink);
  padding: 0.125rem 0.375rem;
  border-radius: 4px;
  font-size: 0.875em;
}

.prose .codeblock,
.docs-content .codeblock { margin: var(--space-5) 0; }

/* Callouts */
.callout {
  border-left: 4px solid;
  border-radius: 0 6px 6px 0;
  padding: 1rem 1.25rem;
  margin: 1.5rem 0;
}
.callout p {
  margin: 0 0 0.5rem;
  line-height: 1.7;
  font-size: 0.9375rem;
}
.callout p:last-child { margin-bottom: 0; }
.callout-title {
  font-weight: 600;
  margin: 0 0 0.25rem;
  font-size: 0.9375rem;
}
.callout-maelezo { border-left-color: var(--ocean); background: var(--ocean-soft); }
.callout-maelezo .callout-title { color: var(--ocean); }
.callout-tahadhari { border-left-color: var(--accent); background: var(--accent-soft-callout); }
.callout-tahadhari .callout-title { color: var(--accent-strong); }
.callout-kidokezo { border-left-color: var(--kijani); background: var(--kijani-soft); }
.callout-kidokezo .callout-title { color: var(--kijani); }

/* Majedwali */
.table-wrap {
  overflow-x: auto;
  margin: 1.5rem 0;
  border: 1px solid var(--border);
  border-radius: 10px;
}
.table-wrap table {
  width: 100%;
  border-collapse: collapse;
  font-size: 0.9375rem;
}
.table-wrap th,
.table-wrap td {
  text-align: left;
  padding: 0.75rem 1rem;
  border-bottom: 1px solid var(--border);
  vertical-align: top;
}
.table-wrap tr:last-child td { border-bottom: none; }
.table-wrap th {
  font-weight: 600;
  color: var(--muted);
  font-size: 0.875rem;
  text-transform: uppercase;
  letter-spacing: 0.04em;
  background: var(--bg-alt);
}
.table-wrap td code {
  font-family: var(--font-mono);
  font-size: 0.9em;
  white-space: nowrap;
}

/* ------------------------------------------------------------
   8. Kadi za sifa, kadi za habari, mnyororo wa kujikusanya
   ------------------------------------------------------------ */
.sifa-eneo {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-6);
}

.sifa-utangulizi { align-self: start; }

.sifa-orodha {
  list-style: none;
  margin: 0;
  padding: 0;
}

.sifa-mstari {
  display: grid;
  grid-template-columns: 2.75rem minmax(0, 1fr);
  gap: var(--space-5);
  padding: var(--space-5) 0;
  border-top: 1px solid var(--border);
  transition: padding-left .25s ease;
}
.sifa-orodha .sifa-mstari:last-child { border-bottom: 1px solid var(--border); }
.sifa-mstari:hover { padding-left: var(--space-2); }

.sifa-namba {
  font-family: var(--font-mono);
  font-size: 0.875rem;
  color: var(--accent);
  padding-top: 0.2rem;
  font-variant-numeric: tabular-nums;
}

.sifa-mstari h3 {
  margin: 0 0 0.375rem;
  font-size: 1.125rem;
  font-weight: 600;
  line-height: 1.3;
}

.sifa-mstari p {
  margin: 0;
  color: var(--muted);
  font-size: 0.9375rem;
  line-height: 1.7;
  max-width: 62ch;
}

.sifa-mstari code {
  font-family: var(--font-mono);
  font-size: 0.875em;
  color: var(--accent-strong);
}

/* Kadi za habari */
.news-grid {
  display: grid;
  grid-template-columns: 1fr;
  gap: var(--space-5);
}

.post {
  background: var(--surface);
  border: 1px solid var(--border);
  border-radius: 10px;
  padding: var(--space-5);
}

.post .date,
.post .post-date {
  display: block;
  font-family: var(--font-mono);
  font-size: var(--fs-xs);
  color: var(--faint);
  margin-bottom: var(--space-2);
  font-variant-numeric: tabular-nums;
}

.post h2 {
  font-family: var(--font-display);
  font-weight: 500;
  font-size: var(--fs-1);
  line-height: 1.3;
  margin: 0 0 var(--space-2);
}

.post h2 a {
  color: var(--ink);
  text-decoration: none;
}
.post h2 a:hover {
  color: var(--accent);
  text-decoration: underline;
  text-underline-offset: 3px;
}

.post p {
  margin: 0;
  color: var(--muted);
  font-size: 0.9375rem;
  line-height: 1.7;
}

.news-more {
  display: inline-block;
  margin-top: var(--space-5);
  color: var(--accent);
  font-weight: 600;
  text-decoration: underline;
  text-underline-offset: 2px;
}
.news-more:hover { color: var(--accent-strong); }

/* Mnyororo wa kujikusanya — mstari mmoja wa kimtiririko, si duara za namba */
.mtiririko {
  display: flex;
  flex-wrap: wrap;
  align-items: flex-start;
  gap: 0.5rem var(--space-2);
  margin: var(--space-6) 0;
  padding: 0;
  list-style: none;
}

.hatua-kipengele {
  display: flex;
  flex-direction: column;
  gap: 0.4rem;
  padding: 0.25rem var(--space-3);
}

.hatua-kipengele code {
  font-family: var(--font-mono);
  font-size: var(--fs-1);
  font-weight: 500;
  color: var(--code-ink);
}

.hatua-kipengele span {
  font-size: 0.8125rem;
  color: var(--code-muted);
}

.hatua-thibitisho code { color: var(--code-link); }

.mtiririko-kiungo {
  align-self: center;
  margin-top: 0.5rem;
  color: var(--code-link);
  opacity: 0.5;
  font-size: 1.125rem;
}

/* ------------------------------------------------------------
   9. Upau wa faharasa wa kurasa za nyaraka
   ------------------------------------------------------------ */
.docs {
  display: grid;
  grid-template-columns: minmax(0, 15rem) minmax(0, 1fr);
  gap: var(--space-7);
  align-items: start;
  padding-block: var(--space-7);
}

.docs-sidebar {
  position: sticky;
  top: 5rem;
  max-height: calc(100vh - 6rem);
  overflow-y: auto;
}

.docs-nav-title {
  font-size: 0.8125rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--faint);
  margin: 0 0 var(--space-2);
  font-weight: 600;
}

.docs-nav ul {
  list-style: none;
  margin: 0;
  padding: 0;
  display: flex;
  flex-direction: column;
  gap: 0.25rem;
}

.docs-link {
  display: block;
  padding: 0.5rem 0.75rem;
  border-radius: 6px;
  color: var(--muted);
  text-decoration: none;
  font-size: 0.9375rem;
  line-height: 1.4;
}
.docs-link:hover { color: var(--ink); background: var(--bg-alt); }
.docs-link.active,
.docs-link[aria-current="location"] {
  color: var(--accent-strong);
  background: var(--accent-soft);
  font-weight: 600;
}

/* ------------------------------------------------------------
   10. Kichwa chini — mhimili wa shaba unaashiria mwisho wa jengo
   ------------------------------------------------------------ */
.site-footer {
  border-top: 3px solid var(--accent);  /* mhimili */
  background: var(--bg-alt);
  padding-block: var(--space-7) var(--space-6);
  font-size: 0.9375rem;
  color: var(--muted);
}

.footer-inner {
  display: grid;
  grid-template-columns: 2fr 1fr 1fr 1fr;
  gap: var(--space-6);
}

.footer-brand { max-width: 24rem; }
.footer-brand .logo { margin-bottom: var(--space-3); }
.footer-brand p { line-height: 1.7; }

.footer-col h4 {
  margin: 0 0 var(--space-2);
  font-size: 0.8125rem;
  text-transform: uppercase;
  letter-spacing: 0.08em;
  color: var(--faint);
  font-weight: 600;
}

.footer-col a {
  display: block;
  color: var(--muted);
  text-decoration: none;
  padding: 0.2rem 0;
}
.footer-col a:hover { color: var(--accent); }

.footer-bottom {
  display: flex;
  justify-content: space-between;
  flex-wrap: wrap;
  gap: var(--space-2) var(--space-4);
  margin-top: var(--space-6);
  padding-top: var(--space-4);
  border-top: 1px solid var(--border);
  font-size: 0.875rem;
  color: var(--faint);
}
.footer-bottom a { color: var(--faint); text-decoration: underline; }
.footer-bottom a:hover { color: var(--accent); }

/* ------------------------------------------------------------
   11. Sehemu za mwanzo (hero) na gridi ya pande mbili
   ------------------------------------------------------------ */
.hero {
  position: relative;
  overflow: hidden;
  padding-block: clamp(3rem, 8vw, 6rem) clamp(3rem, 6vw, 4.5rem);
}

/* Mchoro wa mlango: nakshi moja, hafifu sana, nyuma ya maudhui yote.
   Nyota moja pekee ndani yake ina uhai — inapumua kama taa
   inayopita kwenye tundu lililochongwa. Hakuna mapambo mengine. */
.mlango-sanaa {
  position: absolute;
  top: -10%;
  right: -8%;
  width: min(46rem, 72vw);
  height: auto;
  z-index: 0;
  pointer-events: none;
}
.mlango-sanaa .nyota {
  transform-box: fill-box;
  transform-origin: center;
  animation: mlango-pumzi 8s ease-in-out infinite;
}
.mlango-sanaa .mwanga {
  transform-box: fill-box;
  transform-origin: center;
  animation: mlango-mwako 8s ease-in-out infinite;
}
@keyframes mlango-pumzi {
  0%, 100% { transform: scale(1); }
  50% { transform: scale(1.18); }
}
@keyframes mlango-mwako {
  0%, 100% { opacity: .5; }
  50% { opacity: 1; }
}

.hero-grid,
.split-grid {
  position: relative;
  z-index: 1;
  display: grid;
  gap: var(--space-7);
  align-items: center;
}

.hero-title {
  font-family: var(--font-display);
  font-weight: 500;
  font-size: clamp(2.441rem, 4vw + 1.25rem, 4.2rem);
  line-height: 1.08;
  letter-spacing: -0.02em;
  margin: 0 0 var(--space-5);
}

.accent { color: var(--accent); font-style: italic; }

.hero-lede,
.hero-desc {
  font-size: var(--fs-md);
  line-height: 1.6;
  color: var(--muted);
  max-width: 55ch;
  margin: 0 0 var(--space-6);
}

.hero-cta {
  display: flex;
  flex-wrap: wrap;
  align-items: center;
  gap: var(--space-6);
  margin: 0 0 var(--space-6);
}

.hero-stats {
  font-family: var(--font-mono);
  font-size: var(--fs-sm);
  color: var(--faint);
  display: flex;
  flex-wrap: wrap;
  gap: var(--space-1) var(--space-4);
}
.hero-stats span:not(:last-child)::after {
  content: "\00b7";
  margin-left: var(--space-4);
  color: var(--border-strong);
}

/* ------------------------------------------------------------
   12. Kichwa cha kurasa ndogo
   ------------------------------------------------------------ */
.page-head {
  padding-block: var(--space-7) var(--space-6);
}

.page-head h1 {
  font-family: var(--font-display);
  font-weight: 600;
  font-size: var(--fs-4);
  line-height: 1.08;
  letter-spacing: -0.02em;
  margin: 0;
}

.page-head p {
  font-size: var(--fs-md);
  line-height: 1.6;
  color: var(--muted);
  max-width: 55ch;
  margin: var(--space-3) 0 0;
}

/* ------------------------------------------------------------
   13. Mipaka ya upana: 600px, 900px, 1200px pekee
   ------------------------------------------------------------ */
@media (min-width: 900px) {
  .section,
  .band { padding-block: var(--space-9); }

  .section-alt { padding-block: var(--space-7); }

  .section-head { margin-bottom: var(--space-7); }

  .sifa-eneo {
    grid-template-columns: minmax(0, 0.62fr) minmax(0, 1.38fr);
    gap: var(--space-7);
  }
  .sifa-utangulizi { position: sticky; top: 6rem; }

  .news-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }

  .split-grid { grid-template-columns: minmax(0, 1fr) minmax(0, 1fr); }

  .footer-inner { grid-template-columns: 2fr 1fr 1fr 1fr; }
}

@media (max-width: 899px) {
  /* Urambazaji wa simu: kitufe cha menyu. Bila JS orodha inabaki wazi. */
  html.js .nav-toggle { display: inline-block; }

  html.js .nav { position: relative; }

  html.js .nav-list {
    position: absolute;
    top: calc(100% + 0.5rem);
    right: 0;
    min-width: 13rem;
    background: var(--surface);
    border: 1px solid var(--border-strong);
    border-radius: 6px;
    padding: var(--space-2);
    display: none;
  }

  html.js .nav.open .nav-list { display: block; }

  .nav-list {
    flex-direction: column;
    align-items: stretch;
    gap: 0.25rem;
  }

  .nav-link {
    display: block;
    padding: var(--space-2) var(--space-4);
    font-size: 1rem;
  }

  /* Kurasa za nyaraka: upau unakuwa safu ya usawa inayoteleza */
  .docs {
    grid-template-columns: minmax(0, 1fr);  /* minmax(0,1fr): chips zisizopanue wimbo */
    gap: var(--space-4);
  }

  .docs-sidebar {
    position: static;
    max-height: none;
    overflow-y: visible;
    border-bottom: 1px solid var(--border);
    padding-bottom: var(--space-3);
    margin-bottom: var(--space-6);
  }

  .docs-nav ul {
    flex-direction: row;
    overflow-x: auto;
    gap: 0.25rem;
    padding-bottom: var(--space-1);
  }

  .docs-link { white-space: nowrap; }

  /* Kichwa chini: 2x2 */
  .footer-inner { grid-template-columns: 1fr 1fr; }
  .footer-brand { grid-column: 1 / -1; }
}

@media (max-width: 599px) {
  .wrap,
  .header-inner,
  .footer-inner,
  .footer-bottom,
  section.hero > .hero-grid:not(.wrap),
  section > .split-grid:not(.wrap) { padding-inline: 1rem; }
}

@media (min-width: 1200px) {
  /* Hero ya pande mbili katika umbo lake kamili */
  .hero-grid {
    grid-template-columns: minmax(0, 1.15fr) minmax(0, 0.85fr);
  }
}

/* ------------------------------------------------------------
   14. Taa-onekana — kufunuka kimoja wakati sehemu inapoingia
       kwenye mwonekano. app.js huongeza ".hai" kupitia
       IntersectionObserver.
   ------------------------------------------------------------ */
/* Imefungwa nyuma ya html.js: bila JS, sehemu hizi zinabaki
   zikionekana moja kwa moja — hazitegemei skripti kufunuka. */
html.js .taa-onekana {
  opacity: 0;
  transform: translateY(1.25rem);
  transition: opacity .7s ease, transform .7s ease;
}
html.js .taa-onekana.hai { opacity: 1; transform: translateY(0); }

/* ------------------------------------------------------------
   15. Mwendo uliopunguzwa
   ------------------------------------------------------------ */
@media (prefers-reduced-motion: reduce) {
  html { scroll-behavior: auto; }

  *,
  *::before,
  *::after {
    animation-duration: 0.01ms !important;
    animation-iteration-count: 1 !important;
    transition-duration: 0.01ms !important;
  }
}