# Tasarım Sistemi (Genel Site)

> Yönetim paneli shadcn/ui varsayılanlarını kullanır; bu belge yalnızca **genel siteyi** anlatır.

## 1. Tasarım dili — "Sessiz lüks, klinik hassasiyet"

- **Sinematik koyu sahneler** (hero ve vitrin bölümleri) ile **sıcak, açık okuma bölümleri** dönüşümlü akar.
- Büyük, zarif serif başlıklar + sakin, okunaklı sans gövde metni.
- Bol boşluk, ince çizgiler, yumuşak ışık geçişleri. Süs değil, **anlatım**.
- Fotoğraf gelene kadar görsel dünya **kod ile üretilir**: aurora zeminler, kontur çizgileri,
  çizgisel yüz haritası, kategoriye özel ikonlar.

## 2. Belirteçler (tokens) — markayı değiştirmenin tek yeri

Tüm renk, yazı tipi, yarıçap ve hareket değerleri `resources/css/site.css` içindeki `@theme`
bloğundadır. **Bileşenlerde sabit renk kodu yazılmaz.**

### Renk

| Belirteç                                                                                          | Değer | Kullanım |
| ------------------------------------------------------------------------------------------------- | ----- | -------- |
| Marka renkleri (2026-11-13, K33): **lacivert `#1b1869`**, **mavi `#0782c6`**, **açık `#fafafa`**. |
| Lacivert koyu sahnenin, `#fafafa` açık sahnenin zeminidir; mavi vurgu rengidir. Aradaki tonlar    |
| metni ≥ 4,5:1 kontrastta tutmak için türetildi.                                                   |

| Belirteç                   | Değer                 | Kullanım                                                                       |
| -------------------------- | --------------------- | ------------------------------------------------------------------------------ |
| `ink`, `ink-2…4`           | `#1b1869` → `#3f3c80` | Koyu sahne (marka laciverti) ve üzerindeki yükseltilmiş yüzeyler               |
| `bone`, `bone-2`, `bone-3` | `#fafafa` → `#e6e6ed` | Açık sahne (marka açığı), ayırıcılar                                           |
| `paper`                    | `#ffffff`             | Açık sahnede kart yüzeyi                                                       |
| `mute` / `haze`            | `#585a7a` / `#b3b4d4` | İkincil metin: açık / koyu sahnede (kontrast ≥ 4,5:1)                          |
| `brand`                    | `#0782c6`             | Marka mavisi: ışık, degrade, dolgu. **Metin değil** (açıkta 4:1, koyuda 3,6:1) |
| `brand-soft`               | `#5fb6ea`             | Koyu zeminde vurgu metni ve ışık (lacivertte 6,8:1)                            |
| `brand-deep`               | `#05659c`             | Açık zeminde vurgu metni (`#fafafa` üzerinde 6:1)                              |
| `deep`                     | `#0b4a7c`             | Aurora ışığındaki soğuk denge tonu                                             |
| `danger`                   | `#a4301c`             | Form hataları                                                                  |

> **Markayı değiştirmek:** bu belirteçler + `resources/views/site.blade.php` içindeki `theme-color` ve
> ilk boya rengi (`html { background-color }`, `ink` ile aynı). Logo dosyaları için aşağıdaki "Logo ve
> simgeler" bölümüne bakın.

### Logo ve simgeler

| Dosya                                        | Ne                                                                           |
| -------------------------------------------- | ---------------------------------------------------------------------------- |
| `public/assets/clv-logo.png`                 | Kaynak (6250×2500, beyaz zemin) — sitede kullanılmaz                         |
| `public/assets/brand/clv-clinic.png`         | Açık zemin logosu, 391×120 (40 px'in 3 katı), saydam, 256 renk PNG           |
| `public/assets/brand/clv-clinic-on-dark.png` | Koyu zemin logosu: lacivert→mavi geçişi beyaz→`brand-soft` geçişine çevrildi |
| `public/favicon.ico`                         | İşaret (sol taraftaki şeritli kare), 16 / 32 / 48 px                         |
| `public/apple-touch-icon.png`                | İşaret `#fafafa` zemin üzerinde, 180 px                                      |
| `public/og-default.jpg`                      | Varsayılan paylaşım görseli: logo `#fafafa` üzerinde, altta marka geçişi     |

Üst bilgi, mobil menü ve alt bilgi koyu sahnededir → koyu zemin logosu. JSON-LD (`MedicalClinic.logo`)
açık zemin sürümünü kullanır. Dosyalar `config/site.php` → `defaults.logo` / `defaults.logo_dark`
üzerinden gelir; panelden yüklenen logo kendi karşılığının yerine geçer. Logo `<img>` sunucudan gelen
genişlik/yükseklikle çizilir (kayma yok) ve `fetchPriority="high"` alır (sık sık LCP öğesidir).
Logonun **SVG** sürümü gelirse panelden yüklenebilir; favicon ve panel işareti de ondan yeniden üretilmelidir.

### Sahneler — aynı bileşen koyu ve açık zeminde

Bir bölüm hangi zeminde durduğunu `stage-dark` ya da `stage-light` sınıfıyla bildirir. İçindeki
bileşenler sabit renk yerine **bağlamsal** renkleri kullanır; değerleri sahneden gelir:

| Sınıf                                  | Anlamı                                |
| -------------------------------------- | ------------------------------------- |
| `bg-stage`, `bg-stage-2`, `bg-stage-3` | Zemin ve üzerindeki yüzeyler          |
| `text-fg`, `text-soft`                 | Ana ve ikincil metin                  |
| `border-line`, `border-line-strong`    | Ayırıcılar                            |
| `text-accent-fg`                       | O zeminde okunabilen vurgu metni      |
| `text-accent`, `bg-accent`             | Parlak vurgu (ışık, ikon, koyu zemin) |

### Kategori vurguları

Bir üst öğeye `data-accent="…"` yazmak, altındaki vurgu renklerini (`--accent`, `--accent-2`,
`--accent-ink`) değiştirir. Kategorinin vurgusu veritabanındaki `accent` alanından gelir.
Varsayılan marka mavisidir; kategori vurgusunun altındaki bir bölümü markaya döndürmek için
`data-accent="brand"` yazılır (kategoriye atanamaz, `ContentFiles::ACCENTS` içinde değildir).

| Anahtar     | Ton            | Kategori                                           |
| ----------- | -------------- | -------------------------------------------------- |
| `brand`     | marka mavisi   | Varsayılan (`:root`)                               |
| `copper`    | bakır          | Saç (K37)                                          |
| `champagne` | altın-bej      | Botoks; Medikal Estetik branşı (`config/site.php`) |
| `rose`      | gül            | Dolgu                                              |
| `sage`      | adaçayı        | Mezoterapi                                         |
| `sky`       | soğuk mavi     | Cihazlı İşlemler                                   |
| `citrus`    | kehribar       | IV Tedaviler                                       |
| `slate`     | arduvaz mavisi | Erkek Sağlığı                                      |
| `emerald`   | zümrüt         | Medical Longevity                                  |
| `mauve`     | leylak         | Plastik Cerrahi                                    |
| `pearl`     | inci-aqua      | Diş Sağlığı                                        |
| `blush`     | pudra          | Güzellik                                           |

Yeni bir vurgu eklemek: `site.css`e `[data-accent='ad']` bloğu + `App\Content\ContentFiles::ACCENTS`

- `resources/js/site/types.ts` içindeki `Accent` tipi.

### Yazı tipi

| Rol                        | Aile                           | Not                                     |
| -------------------------- | ------------------------------ | --------------------------------------- |
| Başlık (`font-display`)    | Bricolage Grotesque (değişken) | 200–800; başlıklar 320, vurgu 560 (K27) |
| Gövde/arayüz (`font-sans`) | Onest (değişken)               | 300–700                                 |

- Kendi sunucumuzdan sunulur (üçüncü taraf isteği yok); derleme sırasında indirilir
  (`vite.config.ts` → `fonts`). `font-display: swap`; yedek yazı tipinin ölçüleri eşlenir, bu yüzden
  yazı tipi gelince satırlar kaymaz.
- `latin` + `latin-ext` (Türkçe) alt kümeleri. İlk ekranda gereken dosyalar dile göre önceden yüklenir
  (Türkçe sayfada 4, İngilizce sayfada 2 dosya — `App\Support\FontPreloads`).
- Ölçek akışkandır (`clamp()`): `text-display-1` (hero) → `text-display-4`, `text-lead`, `text-eyebrow`.
- Başlıktaki vurgu metinde yıldızla işaretlenir: `'Güzelliğin bilimi, *iyi yaşamanın* sanatı.'`
  (`Em` bileşeni) ve **kalın + vurgu rengi** olarak basılır (`display-em`; italik yok).

### Diğer

- Yarıçap: `sm 10px` · `md 16px` · `lg 24px` · `xl 36px`
- Hareket eğrileri: `ease-out-expo` (girişler), `ease-in-out-soft` (ortam döngüleri)
- Kap: `shell` (en çok 85rem, akışkan kenar boşluğu) · `shell-narrow` · bölüm boşluğu `section-y` / `section-y-sm`
- Üst bilgi yüksekliği `--header-h`; sayfa içi bağlantılar buna göre kaydırılır

## 3. Bileşenler

`resources/js/site/components/`

| Klasör      | İçerik                                                                                                                                               |
| ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| `layout/`   | `SiteHeader` (şeffaf → koyu; mega menü ve `<dialog>` mobil menü ilk kullanımda kurulur), `SiteFooter`, `LanguageSwitcher`, `Logo`                    |
| `ui/`       | `Button` / `ButtonLink` / `ButtonAnchor`, `SiteLink`, `Eyebrow`, `SectionHeading`, `Em`, `FaqList` (yerel `<details>`), `Breadcrumbs`, ikonlar       |
| `motion/`   | Kaydırma motoru bileşenleri → [`ANIMATIONS.md`](ANIMATIONS.md)                                                                                       |
| `art/`      | `Aurora`, `ContourArt` (tohumlu üretken çizim), `FaceMap`, `CategoryIcon` (her alana bir ikon + `aesthetics`: medikal estetik branşı)                |
| `media/`    | `MediaSlot`, `Picture`, `LazyVideo`                                                                                                                  |
| `sections/` | `PageHero`, `CardGrid`, `TreatmentCard` / `CategoryCard`, `ZoneMap`, `ContactForm`, `CtaBand`; `home/` → `HomeHero`, `AreasShowcase`, `WhatsAppBand` |

Sayfalar: `resources/js/pages/site/` — `home`, `treatments/{index,category,show}`, `about`, `contact`,
`faq`, `legal`, `error`. Ortak düzen: `site/layouts/site-layout.tsx`.

### `MediaSlot` — yer tutucudan gerçek görsele

```tsx
<MediaSlot
    media={treatment.media}
    priority
    className={heroFrame}
    fallback={<ContourArt seed={treatment.key} />}
/>
```

- `media` yoksa `fallback` (üretken görsel) gösterilir.
- Fotoğraf → `Picture`: tarayıcı desteklediği en iyi kodlamayı seçer (AVIF → WebP → JPEG/PNG),
  `width`/`height` yer ayırır (kayma olmaz), ilk ekran dışındakiler tembel yüklenir.
- Video → `LazyVideo`: sessiz, döngülü, `playsinline`; **görünene kadar hiçbir şey indirilmez**,
  ekrandan çıkınca durur. Yanındaki fotoğraf afiştir ve videonun altında normal bir görseldir
  (LCP öğesi olabilir); "hareketi azalt" açıkken yalnızca afiş görünür.
- `media` verisi sunucudan gelir: dosyalar **ada göre** bulunur (`App\Content\MediaLibrary`),
  veritabanı kaydı yoktur. Nereye hangi adla konacağı: [`PLACEHOLDERS.md`](PLACEHOLDERS.md) §Medya.

Bugün yuvası olan yerler: anasayfa hero zemini (`home/hero`), kategori sayfası hero'su
(`categories/<key>`), işlem sayfası hero'su (`treatments/<key>`). Gerçek fotoğraf/video geldiğinde
**koda dokunulmaz**; dosya klasöre konur.

### `CardGrid` — eksik satır bırakmayan ızgara

Kart sayısı veritabanından geldiği için önceden bilinmez. `CardGrid` satırları dengeler: geniş
ekranda en çok 3 (ya da 4) kart, sayı tam bölünmüyorsa son satırlar ikişer **daha geniş** kartla
dolar (7 kart → 3 + 2 + 2; 10 kart → 3 + 3 + 2 + 2). Son satırda tek başına kart kalmaz.

```tsx
<CardGrid items={category.treatments} itemKey={(t) => t.key}>
    {(treatment) => (
        <TreatmentCard treatment={treatment} showCategory={false} />
    )}
</CardGrid>
```

## 4. Bölüm ritmi

- Bölümler arası dikey boşluk: `clamp(96px, 14vw, 200px)`.
- Koyu ↔ açık geçişlerinde araya yumuşak geçiş bandı ya da tam genişlikte sahne girer.
- Bir sayfada en fazla **2–3 sabitlenen (sticky) sahne**; arası sakin okuma bölümleri.

## 5. Erişilebilirlik

- Metin kontrastı ≥ 4,5:1 (büyük başlık ≥ 3:1). `brand` (`#0782c6`) **metin için kullanılmaz** →
  `text-accent-fg` (zemine göre `brand-soft` / `brand-deep`). Odak halkası da `--accent-fg` rengindedir.
- Tüm etkileşimler klavye ile; görünür odak halkası (`:focus-visible`).
- Hareket azaltma tercihinde sahneler **statik** düzene düşer; içerik eksilmez.
- Süs amaçlı SVG'ler `aria-hidden`; anlam taşıyanlarda `role="img"` + `aria-label`.
- Menüler: `aria-expanded`, `Esc` ile kapanma, odak geri dönüşü. İlk sekmede "İçeriğe geç" bağlantısı.

## 6. Yazım ve ton

- Büyük harfli etiketler CSS `uppercase` ile yazılır; `<html lang>` doğru olduğu için tarayıcı
  Türkçe sayfada Türkçe kuralı uygular (`i → İ`, `ı → I`). İki istisna:
    - **İngilizce kalan adlar** ("Medical Longevity") `lang="en"` ile işaretlenir
      ([`I18N.md`](I18N.md) → "Başka dilde kalan adlar").
    - **Marka adı** (`CLINICS`) CSS ile değil JS ile büyütülür (`toUpperCase()`), yoksa Türkçe
      sayfada "CLİNİCS" olur.
- Kısa cümle, etken yapı, vaat yok. Ayrıntı: [`CONTENT_GUIDE.md`](CONTENT_GUIDE.md).

## 7. Anasayfa sahneleri ve yeni parçalar (2026-11-11)

| Parça                   | Dosya                                                 | Not                                                                                                                                                            |
| ----------------------- | ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `HeroField`             | `components/art/hero-field.tsx` + `lib/hero-field.ts` | WebGL "canlı kontur" zemini; renkleri belirteçlerden okur (`--accent`, `--accent-2`, `--color-deep`, `--color-ink`) — marka rengi değişince kendiliğinden uyar |
| `KineticBand`           | `components/sections/home/kinetic-band.tsx`           | Karşı yönlere kayan dev kategori adları (süs; `aria-hidden`)                                                                                                   |
| `ProcessArt`            | `components/art/process-art.tsx`                      | Süreç adımlarının çizimleri: sahnenin statik hâlindeki kartlarda ve tuval çizene kadar; fotoğraf gelince `media/home/process-N.*` yerini alır                  |
| `ProcessStory`          | `components/sections/home/process-story.tsx`          | Süreç sahnesi (K40): sabitlenen bölüm, sırayla gelen metin levhaları, altta ray; statik hâli kartlardır (`ANIMATIONS.md` §11)                                  |
| `LineField`             | `components/art/line-field.tsx` + `lib/line-field.ts` | Sahnenin "dönüşen çizgileri" (Canvas 2D); renkleri belirteçlerden okur (`--accent`, `--color-bone`) — marka rengi değişince kendiliğinden uyar                 |
| `Tilt`                  | `components/motion/tilt.tsx`                          | Kart fareye doğru eğilir, ışık imleci izler (yalnızca fare)                                                                                                    |
| `ScrollProgress`        | `components/layout/scroll-progress.tsx`               | Pencerenin üstünde okuma ilerleme çizgisi (tüm sayfalarda)                                                                                                     |
| `PostCard`, `PostCover` | `components/sections/post-card.tsx`                   | Blog kartı; kapak yoksa yazının anahtarıyla tohumlanan `ContourArt`                                                                                            |
| `ContactMap`            | `components/sections/contact-map.tsx`                 | Görünene kadar yüklenmeyen harita çerçevesi (K24)                                                                                                              |
| `LanguageSwitcher`      | `components/layout/language-switcher.tsx`             | `variant="menu"` (üst bilgi, bayraklı açılır menü) · `inline` (alt bilgi, mobil menü)                                                                          |

**Vurgu metni:** `text-accent-fg`, en yakın `data-accent` öğesinin tonunu kullanır — koyu sahnede
parlak ton, açık sahnede okunur "ink" tonu (K26). Kartlara `data-accent` vermek yeterlidir.

**Alt bilgi akreditasyonu:** HealthTürkiye logosu açık renkli bir karo üzerinde durur (logo açık
zemin için çizilmiş); yanında yetki belgesi PDF'ine bağlantı. Dosya yolları `config/site.php` → `accreditation`.

## 8. Klinik parçaları (2026-11-12)

| Parça               | Dosya                                          | Not                                                                                               |
| ------------------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| `TopBar`            | `components/layout/top-bar.tsx`                | Büyük ekranda üst şerit: saat, ilçe, telefon, e-posta, sosyal; kaydırınca gizlenir (`--topbar-h`) |
| `FloatingContact`   | `components/layout/floating-contact.tsx`       | Sağ altta sabit WhatsApp düğmesi: her durumda kısa form panelini açar, numaraya bağlanmaz (K39)   |
| `HeroBackdrop`      | `components/sections/home/hero-backdrop.tsx`   | Hero arkasında soluk, geçişli fotoğraflar (`media/home/backdrop-*`)                               |
| `Certificates`      | `components/sections/certificates.tsx`         | Üyelik/belge logoları: koyu zeminde tek renkli kayan şerit, açık zeminde renkli ızgara            |
| `ClinicGallery`     | `components/sections/clinic-gallery.tsx`       | Mozaik (anasayfa) / ızgara (hakkımızda) + tam ekran görüntüleyici (`<dialog>`)                    |
| `AppointmentWizard` | `components/sections/appointment-wizard.tsx`   | Üç adımlı randevu formu: Bilgiler → Alan → Uygulama; ilk adım CRM formu ya da sitenin formu (K35) |
| `ReviewsSection`    | `components/sections/home/reviews-section.tsx` | Platform puanları + yorum kartları; yorum yoksa yalnızca bağlantı şeridi                          |

**2026-11-13 (K34, K35):**

| Parça            | Dosya                                         | Not                                                                                                                                                                                                       |
| ---------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `AreasShowcase`  | `components/sections/home/areas-showcase.tsx` | Branş dizini + her **ana branşa** bir panel (K37); paneller üst üste biner, tutulurken sahneleri oynar (`.areas-deck`, `ANIMATIONS.md` §8); diğer alanlar yalnızca dizinde, branşların ardından           |
| `AreaScene`      | `components/sections/home/area-scenes.tsx`    | Branşların çizim sahneleri (saç, diş, yüz/medikal estetik, erkek sağlığı + genel); parçalar panelin saatlerini okur; yeni branş → buraya bir sahne                                                        |
| `CrmForm`        | `components/sections/crm-form.tsx`            | CRM'in form sayfası çerçevede: `message` / `whatsapp`; `onStored` ile adım adım forma bağlanır; yükseklikler `FRAME`                                                                                      |
| `lib/crm-form`   | `lib/crm-form.ts`                             | Çerçevenin adresi ve iç stil sayfası; renkleri çevredeki belirteçlerden okur (koyu/açık sahneye uyar)                                                                                                     |
| `WhatsAppBand`   | `components/sections/home/whatsapp-band.tsx`  | Anasayfada WhatsApp formu (ad + telefon, tek satır) ve gerçek sayılarla halka; CRM açıkken CRM çerçevesi, kapalıyken sitenin kısa formu — bağlantı yok (K39)                                              |
| `WhatsAppButton` | `components/ui/whatsapp-button.tsx`           | "WhatsApp ile yazın": her durumda sabit düğmenin panelini açar (`lib/whatsapp-form.ts`); bağlantı değil düğmedir (K39)                                                                                    |
| `WhatsAppForm`   | `components/sections/whatsapp-form.tsx`       | Sitenin kendi kısa formu (ad soyad + telefon + onay), CRM kapalıyken: talep panelde saklanır, yanıtla gelen adresle sohbet açılır; alanlar her sahnede açık zeminli; kendi genişliğine göre dizilir (K39) |
| `FormDone`       | `components/sections/form-done.tsx`           | Form yerine geçen onay; sitede WhatsApp'a bağlanan **tek** yer ("WhatsApp'ı aç"), yalnızca kayıttan sonra (K39)                                                                                           |

**WhatsApp yeşili (2026-11-16):** sohbete götüren düğmeler `Button`/`ButtonAnchor` → `variant="whatsapp"`
kullanır (`--color-whatsapp` zemin, lacivert yazı 7,7:1; üzerine gelince `--color-whatsapp-soft`): anasayfa
bandı, CRM çerçevesindeki gönder düğmesi, onay ekranındaki "WhatsApp’ı aç", sabit düğme. Başka bir birincil
düğmenin yanında duran "WhatsApp ile yazın" (`WhatsAppButton`) çerçeveli kalır. Simge tek yerden gelir
(`lib/whatsapp-glyph.ts`: dolu tek yol) — hem `WhatsApp` ikonu hem çerçevenin stil sayfası onu çizer; çerçevede
adresle taşındığı için kısa tutulur (adres ≈ 5,5 KB; sunucuların istek satırı sınırı ≈ 8 KB).

- **Logolar:** `public/assets/certificates/{anahtar}.webp` (renkli) ve `{anahtar}-mono.webp` (açık tek renk);
  sıra ve adlar `config/site.php` → `certificates`. Yeni logo: iki dosyayı koy, listeye bir satır ekle.
- **Görseller ve `sizes`:** `Picture`/`MediaSlot` bir `sizes` alır; medya kütüphanesindeki küçük kopyalar
  (`ad@800.avif`) srcset'e girer, tarayıcı ekranına uygun olanı indirir.

## 9. İç sayfa parçaları (2026-11-16, K38)

Hareket kuralları ve sayfa sayfa döküm: [`ANIMATIONS.md`](ANIMATIONS.md) §10.

| Parça            | Dosya                                                            | Ne yapar                                                                                                                                 |
| ---------------- | ---------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
| `PageHero`       | `components/sections/page-hero.tsx`                              | İç sayfa hero'su: `visual` (fotoğraf ya da yerini tutan çizim), `art` (sayfanın çizimi), imleç ışığı; `sheet`: sonraki bölümün sınıfları |
| `Spotlight`      | `components/motion/spotlight.tsx`                                | Koyu bölümde fareyi izleyen ışık ve aydınlanan ızgara; çizimlere imleç konumunu verir                                                    |
| Sayfa çizimleri  | `components/art/{atlas,map,dialogue,journal,legal,zone}-art.tsx` | Tedaviler, iletişim, SSS, blog, yasal sayfalar ve bölgeli işlemler için kendini çizen çizimler                                           |
| `ContourArt`     | `components/art/contour-art.tsx`                                 | `alive`: halkalar tek tek girer, yavaşça döner, imleçle derinlik kazanır (hero'larda)                                                    |
| `PrincipleArt`   | `components/art/principle-art.tsx`                               | Hakkımızda'daki dört ilkenin küçük çizimleri                                                                                             |
| `FactIcon`       | `components/art/fact-icon.tsx`                                   | İşlem sayfasındaki hızlı bilgilerin ikonları (süre, anestezi, iyileşme, etki, kalıcılık, seans)                                          |
| `CategoryScene`  | `components/art/category-scenes.tsx`                             | Kategori sayfalarının çizim sahneleri (alan anahtarıyla seçilir); yeni alan → buraya bir sahne                                           |
| `TreatmentStory` | `components/sections/treatment-story.tsx`                        | Kategori sayfasında uygulamalar alanın çizimiyle birlikte: çizim sabit, liste ilerledikçe sahne ilerler                                  |
| `SectionNav`     | `components/sections/section-nav.tsx`                            | "Bu sayfada" bağlantıları; yeri kaydırılınca üst bilginin altında okuru izleyen çubuk (işaretçi kısayolu, `aria-hidden`)                 |
| `useSectionSpy`  | `hooks/use-section-spy.ts`                                       | Sayfadaki hangi bölümün/başlığın okunduğunu bildirir (konumlar boyut değişince ölçülür, kaydırırken değil)                               |
| `kit`            | `components/art/kit.ts`                                          | Çizim yardımcıları: `turn()` (giriş sırası), `depth()` (imleçle kayma), `about()` (dönme merkezi)                                        |

- **Açık zeminde çizim:** aksanın parlak tonu açık zeminde soluk kalır; çizgi `acf`, dolgu `aff` kullanır
  (`--accent-fg`). Koyu zeminde `ac` / `af`.
- **Hikâye çerçevesi** (`.story-stage`): çizim ince çerçeveli, alttan aksan ışıklı bir kutuda durur; en çok
  `50svh`.
- **`needs-js`:** yalnızca uygulama çalışınca işe yarayan bir denetim (SSS araması) yerini korur ama o ana dek
  görünmez — yer kaplar, sıçrama olmaz, işlevsiz denetim görünmez.
