Tokens · Layout

Z-index ladder

On katmanlı sabit z-index merdiveni. Her UI bileşeninin yığılma sırası tek bir token tablosundan okunur — keyfi z-index: 9999 yasaktır. Aralarındaki 10 birimlik boşluk, yerel istisnalar (örn. modal içinde tooltip) için manevra alanı bırakır.

01 · Görsel merdiven

Yukarıya doğru yükselen on katman; numara token'ın değeri

Toast / Notification 80

Modal backdrop 40

Top nav · Banner 20

Sticky table header 10

Base flow 0

02 · Token tablosu

Tüm token'lar colors_and_type.css içinde tanımlıdır

Token	Değer	Kim kullanır?
--nb-z-base	0	Default akış; kanban kartları, içerik blokları
--nb-z-sticky	10	Sticky tablo başlığı, sticky CTA çubuğu, sayfa içi sekmeler
--nb-z-nav	20	Top nav, üst banner / inline alert (page-level)
--nb-z-dropdown	30	User-chip menüsü, select listesi, date picker takvimi
--nb-z-modal-backdrop	40	`rgba(0,0,0,.5)` backdrop — modal/drawer arkası
--nb-z-sidebar	50	Mobile slide-in sidebar (desktop'ta yok)
--nb-z-modal	60	Modal dialog, drawer/sheet, command palette (⌘K)
--nb-z-popover	70	Popover, combobox listesi, mention/autocomplete
--nb-z-toast	80	Toast / notification (sağ alt, 6 saniye)
--nb-z-tooltip	90	Tooltip — her şeyin üstünde, içerik aktarmaz

Kurallar

· Tüm üst-üste binen UI token kullanır; z-index: 9999 yasak.
· Yığın içinde lokal istisna gerekiyorsa (örn. modal içindeki tooltip), aynı token + +1 kullan: z-index: calc(var(--nb-z-tooltip) + 1).
· Backdrop her zaman modal'dan tam 20 birim aşağıdadır; backdrop ile modal arasına başka şey girmez.
· Sidebar yalnızca mobilde z-stack alır; desktop'ta position: static.
· Tooltip içinde portal kullanılıyorsa parent'tan bağımsız olarak --nb-z-tooltip uygulanır — z-index parent stacking-context'ine göre ölçülür, dikkatli ol.
· Yeni katman ekleme: önce mevcut on katmandan biriyle eşleştirebilir misin diye sor; gerçekten yeni ise tabloya yaz, atomic versiyon bump'la (changelog kartı).