@ahmetilhn/hanui 2.0.10 → 2.2.0

package/build/index.d.ts

@@ -26,37 +26,7 @@ export declare const ABOVE_TABLET_MEDIA_QUERY = "(min-width: 1025px)";
 
 export declare const Accordion: typeof Accordion_2;
 
-/**
- * Akordeon — katlanabilir bölümler.
- *
- * <h3>Yerel `<details>` / `<summary>` üzerine</h3>
- * Açık/kapalı durumu, klavye desteği (`Enter` ve `Space`), ekran okuyucu
- * duyurusu ("genişletildi/daraltıldı") ve <strong>sayfa içi bulma</strong>
- * tarayıcıdan gelir. Sonuncusu taklit bir uygulamada imkânsız: Ctrl+F ile
- * aranan bir metin kapalı bir `<details>`in içindeyse tarayıcı bölümü kendisi
- * açıyor; `display: none` ile gizlenmiş bir `<div>`de o metin hiç yok.
- *
- * <p>Bedeli, tek-açık kipin elle kurulması: `<details name="…">` bunu yerel
- * olarak veriyor ama Safari 17.2 öncesinde yok ve orada TÜM bölümler
- * birbirinden bağımsız açılıyordu — sessiz bir davranış farkı. Karar burada
- * veriliyor, tarayıcıya bırakılmıyor.
- *
- * <h3>Yükseklik geçişi</h3>
- * `interpolate-size: allow-keywords` + `height` geçişi ile `auto`ya
- * canlandırılıyor. Desteklemeyen tarayıcıda geçiş düşer ve bölüm ANINDA
- * açılır — eski davranış. Sabit bir piksel yüksekliği vermek ya da
- * `max-height` numarası kullanmak yanlış: ilki içeriği kırpıyor, ikincisi
- * kısa bölümlerde gözle görülür bir gecikme bırakıyordu.
- *
- * <h3>Klavye (yerel)</h3>
- * <table>
- *   <tr><td>`Enter` / `Space`</td><td>bölümü açar/kapatır</td></tr>
- *   <tr><td>`Tab`</td><td>başlıklar arasında gezinir</td></tr>
- * </table>
- * Ok tuşu YOKTUR ve olmamalı: akordeon bir liste değil, her başlık bağımsız
- * bir düğme (WAI-ARIA APG accordion deseni ok tuşlarını isteğe bağlı bırakıyor
- * ve yerel öğe onları getirmiyor).
- */
+/** Akordeon — katlanabilir bölümler. */
 declare const Accordion_2: FC<Props_35>;
 
 export declare type AccordionItem = {
@@ -71,13 +41,7 @@ export declare type AccordionItem = {
 
 export declare const Alert: typeof Alert_2;
 
-/**
- * Bilgi / uyarı kutusu.
- *
- * <p>`danger` ve `warning` tonları `role="alert"` taşır: ekran okuyucu bunları
- * anında duyurur. `info` ve `success` duyurulmaz — sayfa yüklenirken her bilgi
- * kutusunun okunması gürültü olurdu.
- */
+/** Bilgi / uyarı kutusu. */
 declare const Alert_2: FC<Props_17>;
 
 export declare type AlertTone = 'info' | 'success' | 'warning' | 'danger';
@@ -87,59 +51,12 @@ export declare type AnnouncePoliteness = 'polite' | 'assertive';
 
 export declare const Avatar: typeof Avatar_2;
 
-/**
- * Avatar — kullanıcı madalyonu.
- *
- * <h3>Görsel yoksa baş harf</h3>
- * Profil görseli olmayan bir sistemde baş harf madalyonu kimliği
- * <em>yeterince</em> taşır: kullanıcı hesap menüsünün en üstünde doğru hesapta
- * olduğunu görmek ister, fotoğrafını değil. `imageUrl` verildiğinde görsel
- * çizilir ve baş harf yedeğe düşer; çağıran tarafların değişmesi gerekmez.
- *
- * <h3>Ekran okuyucuya okunmaz</h3>
- * Madalyon `aria-hidden`: yanında zaten adın kendisi yazıyor. İkisini de
- * okumak "A İ Ahmet İlhan" gibi bir gürültü üretiyordu. Adın yanında
- * durmadığı bir yerde kullanılıyorsa çağıran taraf metni kendisi yazar.
- */
+/** Avatar — kullanıcı madalyonu. */
 declare const Avatar_2: FC<Props_18>;
 
 export declare const Badge: typeof Badge_2;
 
-/**
- * Rozet — durum ve sınıflandırma etiketi.
- *
- * <p><strong>Renk tek başına anlam taşımaz</strong> (WCAG 1.4.1): her rozet
- * okunabilir bir metin içerir. `tone` yalnızca metni pekiştirir; renk körü bir
- * kullanıcı da aynı bilgiyi alır.
- *
- * <h3>Durum tonlarında `solid` ile `soft` aynı şeyi verir</h3>
- * Bu bilinçli. <strong>Doygun dolgu = tıklanabilir</strong> kuralı gereği dolu
- * zeminli bir durum etiketi düğmeye benziyor ve kullanıcılar "Son 2 adet" gibi
- * bir etikete tıklamayı deniyordu. Prop çağıran tarafları kırmamak için
- * korundu, görünüm tint'e sabitlendi.
- *
- * <p>Doygun dolgu yalnızca <strong>miktar</strong> tonlarında (`action`,
- * `link`) anlamlı: onlar bir durumu değil bir sayıyı bildirir ve tıklanabilir
- * bir öğenin parçasıdır.
- *
- * <h3>Koyu bandın üzerinde: `neutral` yeniden bağlanır</h3>
- * Nötr rozet üç CSS özel özelliği okur — `--hanui-badge-bg`,
- * `--hanui-badge-fg`, `--hanui-badge-line`. Kapsayıcıda tanımlanmadıklarında
- * varsayılan tint çizilir; koyu bir gezinme rayının içinde ise kapsayıcı
- * üçünü kendi tonlarına bağlayarak rozeti oraya taşır. İç sınıflara kural
- * yazmak bir sonraki yayında sessizce düşerdi.
- *
- * ```scss
- * .rail__badge {
- *   --hanui-badge-bg: #{$rail-hover};
- *   --hanui-badge-fg: #{$rail-fg-2};
- *   --hanui-badge-line: #{$rail-line};
- * }
- * ```
- *
- * <p>Durum tonları bilinçli olarak ezilemez: bir hata rozetini kapsayıcının
- * sessizce nötrleştirmesi, rengin taşıdığı anlamı yok ederdi.
- */
+/** Rozet — durum ve sınıflandırma etiketi. */
 declare const Badge_2: FC<Props_19>;
 
 export declare type BadgeTone = 'neutral' | 'success' | 'danger' | 'warning' | 'info'
@@ -223,11 +140,6 @@ declare type BaseProps_4 = {
     /**
      * Sayfa değiştiğinde ekran okuyucuya duyurulacak metin
      * ("3. sayfa · 1.248 sonuç").
-     *
-     * <p>Verilmediğinde duyuru YAPILMAZ. Görsel tarafta sayfa numarası
-     * `aria-current` ile zaten işaretli ama o yalnızca ODAK oraya geldiğinde
-     * okunuyor: bağlantıya basıp listenin başına dönen kullanıcı, kaçıncı
-     * sayfada olduğunu ve kaç sonuç kaldığını hiç duymuyordu.
      */
     formatAnnouncement?: (page: number, totalPages: number) => string;
     className?: string;
@@ -238,32 +150,10 @@ export declare const BottomSheet: MemoExoticComponent<({ title, closeLabel, onCl
 
 export declare const Breadcrumb: typeof Breadcrumb_2;
 
-/**
- * Kırıntı yolu.
- *
- * <p>Son öğe bağlantı DEĞİL ve `aria-current="page"` taşır: bulunduğu sayfaya
- * bağlantı veren bir kırıntı yolu, ekran okuyucu kullanıcısını yanıltır.
- *
- * <p>Ayırıcı ikon `aria-hidden`; ekran okuyucu liste yapısından hiyerarşiyi
- * zaten anlar.
- */
+/** Kırıntı yolu. */
 declare const Breadcrumb_2: FC<Props_20>;
 
-/**
- * Yapılandırmayı CSS metnine çevirir.
- *
- * <h3>Neden yalnızca EZİLEN token'lar yazılıyor</h3>
- * Tam eşlemeyi yazmak da çalışırdı ama iki bedeli var: çıktı 90 satır yerine
- * 4 satır olurdu ve daha önemlisi, kütüphane bir sonraki sürümde bir token'ın
- * varsayılanını değiştirdiğinde tüketicinin sayfası ESKİ değeri yazmaya devam
- * ederdi — üstelik ezmediği bir token için. Ezmeler ne ise o yazılır.
- *
- * <h3>Neden `<style>`, neden satır içi stil değil</h3>
- * Satır içi stil yalnızca `<html>` üzerinde durur ve `[data-hanui-theme]`
- * seçicisinden daha yüksek özgüllüktedir: kullanıcı temayı değiştirdiğinde
- * ezmeler HER İKİ temada da aynı kalıyordu. Ayrı bir kural bloğu, açık ve
- * koyu ezmeleri kendi seçicilerine bağlar.
- */
+/** Yapılandırmayı CSS metnine çevirir. */
 export declare const buildThemeCss: (config: HanuiThemeConfig) => string;
 
 export declare const Button: typeof Button_2;
@@ -271,27 +161,9 @@ export declare const Button: typeof Button_2;
 /**
  * Düğme.
  *
- * <h3>Yüklenirken içerik korunur</h3>
- * Metin dönen çarkla DEĞİŞTİRİLMEZ, yanına eklenir ve düğme genişliği
- * sabitlenir. Metni değiştirmek düğmeyi daraltıp yerleşimi kaydırıyordu ve
- * kullanıcı neye tıkladığını kaybediyordu.
- *
- * <h3>Bağlantı mı düğme mi</h3>
- * `href` verilirse `<a>` çizilir. Görsel olarak düğme gibi duran bir
- * bağlantının gerçekten `<a>` olması gerekir: orta tuşla yeni sekmede
- * açılması ve tarayıcı geçmişine girmesi beklenen davranıştır.
- *
- * <p>`isExternal` ile birlikte yönlendirici DEĞİL ham `<a>` çizilir ve
- * `target="_blank"` + `rel="noopener noreferrer"` eklenir. Uygulama dışı bir
- * adres için yönlendiriciyi araya sokmak anlamsız; `rel` ise zorunlu —
- * `noopener` olmadan açılan sekme `window.opener` üzerinden bu sayfaya
- * erişebiliyor. Düğme benzeri dış bağlantı elle `<a>` olarak yazılmasın diye
- * burada: elle yazılan her bağlantı odak halkasını ve durum matrisini yeniden
- * kurmak zorunda kalıyordu.
- *
  * @example
  * <Button variant={UIVariant.PRIMARY} isLoading={isSaving} onClick={save}>
- *   Kaydet
+ * Kaydet
  * </Button>
  */
 declare const Button_2: ForwardRefExoticComponent<Partial<{
@@ -318,14 +190,7 @@ linkProps?: HanuiLinkExtraProps;
 } & RefAttributes<HTMLButtonElement>>;
 
 declare type ButtonProps = BaseProps_4 & {
-    /**
-     * Sayfa değişimi adres çubuğu YERİNE buraya bildirilir.
-     *
-     * <p>Yalnızca sayfalamanın adrese yazılmadığı listeler için: kişiye özel,
-     * `noindex` ekranlarda kimse "ikinci sayfa" bağlantısını paylaşmıyor ve orada
-     * adresi kirletmek geri tuşunu kullanılamaz hâle getiriyordu. Bağlantı
-     * verilebilecek bir hedef olmadığı için numaralar düğme kalır.
-     */
+    /** Sayfa değişimi adres çubuğu YERİNE buraya bildirilir. */
     onPageChange: (page: number) => void;
     buildHref?: never;
     linkProps?: never;
@@ -336,26 +201,14 @@ export declare const Card: typeof Card_2;
 /**
  * Kart — medya + gövde + eylem şeridi.
  *
- * <h3>Neden bileşik (compound) bir bileşen</h3>
- * Bir uygulamadaki her kart (ürün, kampanya, sipariş) aynı üç bölümden oluşur
- * ama içerikleri tamamen farklıdır. Tek bir "her şeyi yapan" kart bileşeni on
- * beş isteğe bağlı prop'a şişiyordu. Bunun yerine <em>yerleşim</em>
- * paylaşılır, içerik çağırana bırakılır: kenarlık, yarıçap, gölge, medya oranı
- * ve eylem şeridinin dipte durması tek yerde tanımlıdır.
- *
- * <h3>Eylem şeridi hep dipte</h3>
- * {@link CardFooter} `margin-top: auto` alır. Izgarada yan yana duran kartların
- * başlıkları farklı uzunlukta olsa da alt şerit aynı hizada kalır; aksi hâlde
- * satır dalgalı görünüyordu.
- *
  * @example
  * <Card as="article" isInteractive>
- *   <CardMedia href="/urun/x" ratio={1}>
- *     <CardOverlay position="top-left"><Badge>Yeni</Badge></CardOverlay>
- *     <img src={…} alt="" />
- *   </CardMedia>
- *   <CardBody>…</CardBody>
- *   <CardFooter>…</CardFooter>
+ * <CardMedia href="/urun/x" ratio={1}>
+ * <CardOverlay position="top-left"><Badge>Yeni</Badge></CardOverlay>
+ * <img src={…} alt="" />
+ * </CardMedia>
+ * <CardBody>…</CardBody>
+ * <CardFooter>…</CardFooter>
  * </Card>
  */
 declare const Card_2: FC<CardProps>;
@@ -366,38 +219,10 @@ export declare const CardBody: FC<CardSectionProps>;
 /** Eylem şeridi — tutar, düğmeler. Kartın dibine yapışır. */
 export declare const CardFooter: FC<CardSectionProps>;
 
-/**
- * Kartın görsel alanı.
- *
- * <p>Oran <strong>sabittir</strong>: görsel yüklenene kadar yer tutar ve
- * yerleşim kaymasını (CLS) önler. Oransız bırakıldığında kartlar görseller
- * yüklendikçe zıplıyordu.
- *
- * <p>Görselin çerçeveyi doldurma biçimi ÇAĞIRANIN kararı ({@link CardMediaFit}):
- * kütüphane "her ürün fotoğrafı içeriden dursun" gibi bir tercihi kendi
- * varsayılanına gömmez. Varsayılan `contain` — kırpmayan, yani hiçbir bilgiyi
- * sessizce yok etmeyen seçenek.
- */
+/** Kartın görsel alanı. */
 export declare const CardMedia: FC<CardMediaProps>;
 
-/**
- * Görselin çerçeveyi NASIL doldurduğu.
- *
- * <p>Üçü de aynı soruyu yanıtlıyor — <em>kırpılsın mı, sığsın mı, yoksa
- * içeriden mi dursun</em> — bu yüzden tek bir prop'un değerleri; ayrı ayrı
- * boolean'lar olsalardı `isContained={false} isInset` gibi anlamsız
- * bileşimler yazılabilir hâle gelirdi.
- *
- * <ul>
- *   <li><b>`cover`</b> — çerçeveyi tamamen doldurur, taşan kenarları KIRPAR.
- *       Kadraj kenara kadar anlamlı olan fotoğraflar (kampanya, kapak).</li>
- *   <li><b>`contain`</b> — kırpmadan sığdırır; uzun kenarı çerçeve dolgusuna
- *       dayanır. Karışık oranlarda gelen görseller.</li>
- *   <li><b>`inset`</b> — sığdırır ve <b>%85</b>e çekip merkezler. Şeffaf
- *       zeminli ürün fotoğrafları: parçanın kenarı kartın kenarına
- *       değmiyor.</li>
- * </ul>
- */
+/** Görselin çerçeveyi NASIL doldurduğu. */
 export declare type CardMediaFit = 'cover' | 'contain' | 'inset';
 
 declare type CardMediaProps = {
@@ -414,19 +239,13 @@ declare type CardMediaProps = {
      * @deprecated `fit` kullanın: `isContained` → `fit="contain"`,
      * `isContained={false}` → `fit="cover"`. Boolean yalnızca iki durumu
      * anlatabiliyordu, üçüncüsü (`inset`) ona sığmadı. Eski yol bir sürüm daha
-     * çalışır; `docs/MIGRATION.md`.
+     * çalışır; `CLAUDE.md` → Göç.
      */
     isContained?: boolean;
     className?: string;
 };
 
-/**
- * Görselin üzerine binen katman: rozetler ve hızlı eylemler.
- *
- * <p>Varsayılan olarak `pointer-events: none` — rozet yığını, altındaki görsel
- * bağlantısının tıklanmasını engellememeli. İçindeki gerçek düğmeler kendi
- * olaylarını geri açar.
- */
+/** Görselin üzerine binen katman: rozetler ve hızlı eylemler. */
 export declare const CardOverlay: FC<CardOverlayProps>;
 
 declare type CardOverlayProps = {
@@ -452,53 +271,12 @@ declare type CardSectionProps = {
 
 export declare const Carousel: typeof Carousel_2;
 
-/**
- * Kaydırılabilir şerit (carousel).
- *
- * <h3>OTOMATİK OYNATMA YOK — ve olmayacak</h3>
- * Kendiliğinden ilerleyen bir şerit WCAG 2.2.2'yi ihlal ediyor (beş saniyeden
- * uzun süren hareket duraklatılabilmeli) ama asıl sorun daha basit: kullanıcı
- * okumaya başladığı kartı kaybediyor. Bir prop olarak bile eklenmedi —
- * eklenseydi kullanılırdı.
- *
- * <h3>Kaydırma YEREL, JavaScript değil</h3>
- * Şerit `overflow-x: auto` + `scroll-snap`: dokunmatikte parmakla kaydırma,
- * masaüstünde shift+tekerlek ve <strong>klavyeyle ok tuşları</strong>
- * tarayıcıdan geliyor. JavaScript ile `transform` kaydıran bir uygulama
- * bunların hiçbirini getirmiyor ve kaydırma çubuğunu da götürüyor — kullanıcı
- * şeridin devam ettiğini göremiyordu.
- *
- * <p>Düğmeler `scrollBy` çağırıyor: yerel kaydırmayı DEĞİŞTİRMİYOR,
- * tetikliyor. İkisi aynı durumu paylaşıyor ve ayrışmaları imkânsız.
- *
- * <h3>Şerit klavyeyle ULAŞILABİLİR</h3>
- * Kaydırılabilir bir kutu, içinde odaklanabilir öğe yoksa `tabindex`
- * verilmediğinde klavye kullanıcısı için ulaşılamaz (WCAG 2.1.1). Şerit
- * genellikle bağlantı taşıyan kartlardan oluşuyor ve o durumda ek bir durak
- * gereksiz — bu yüzden `tabindex` yalnızca <strong>odaklanabilir çocuk
- * yoksa</strong> yazılıyor.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Tab`</td><td>önceki/sonraki düğmelerine ve kartların içine</td></tr>
- *   <tr><td>ok tuşları</td><td>şeridi kaydırır (yerel)</td></tr>
- * </table>
- */
+/** Kaydırılabilir şerit (carousel). */
 declare const Carousel_2: FC<Props_21>;
 
 export declare const Checkbox: typeof Checkbox_2;
 
-/**
- * Onay kutusu.
- *
- * <p>Yerel `<input type="checkbox">` korunur ve `accent-color` ile
- * renklendirilir. Özel bir kutu çizmek (gizli input + sahte kare) klavye
- * odağını ve ekran okuyucu davranışını elle yeniden kurmayı gerektirir;
- * kazanç görsel, maliyet erişilebilirlik.
- *
- * <p>Tüm satır tıklanabilir (`<label>` sarmalar): 18 px'lik kareyi
- * hedeflemek özellikle dokunmatik ekranda yorucu.
- */
+/** Onay kutusu. */
 declare const Checkbox_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
 label: ReactNode;
 hint?: string;
@@ -507,32 +285,7 @@ testId?: string;
 
 export declare const Chip: typeof Chip_2;
 
-/**
- * Çip — seçilebilir etiket.
- *
- * <h3>Tasarım sisteminin en çok tekrarlanan öğesi</h3>
- * Kategori seçimi, hızlı filtre, sıralama tercihi, görünüm anahtarı: hepsi
- * aynı öğe. Ayrı ayrı düğme stilleri yazmak yerine tek çip kullanılır;
- * böylece seçili durumun nasıl göründüğü uygulamanın her yerinde aynıdır.
- *
- * <h3>Seçili durum üç sinyalle birden bildirilir</h3>
- * Kenarlık + metin rengi + ikon rengi <em>birlikte</em> değişir. Yalnızca
- * zemini doldurmak (renk tek başına, WCAG 1.4.1) renk körü kullanıcı için
- * ayırt edilemez olurdu; ayrıca dolu zemin çipi düğmeye benzetip "buraya
- * tıkla" gibi okutuyordu — oysa çip bir <em>durum</em> gösterir.
- *
- * <h3>Neden `aria-pressed`, `disabled` değil</h3>
- * Seçili çip pasifleştirilmez: kullanıcı seçimini geri alabilmeli. Basılı
- * düğme semantiği (`aria-pressed`) ekran okuyucuya "seçili, kapatılabilir"
- * bilgisini verir.
- *
- * <h3>Native `title` YAZILMAZ</h3>
- * Görünür metni olmayan çip `label`ı yalnızca `aria-label`a koyar. Önce
- * ikisini birden yazıyordu; tarayıcının balonu dokunmatikte hiç görünmez,
- * klavyede gecikmeli çıkar ve biçimi işletim sistemine bağlıdır — yani
- * "üzerine gelince ne olduğu yazar" sözü kullanıcıların çoğunda tutmuyordu.
- * Açıklama isteyen çağıran çipi {@link Tooltip} ile sarar.
- */
+/** Çip — seçilebilir etiket. */
 declare const Chip_2: ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
 /** Görünen metin. Yalnız ikon taşıyan çipte verilmez; `label` zorunlu olur. */
 children?: ReactNode;
@@ -564,36 +317,7 @@ testId?: string;
 
 export declare const ChipGroup: typeof ChipGroup_2;
 
-/**
- * Çip grubu — açılır liste yerine tek dokunuşla seçim.
- *
- * <h3>Ne zaman çip grubu, ne zaman açılır liste</h3>
- * Seçenek sayısı azsa (kabaca 7'ye kadar) ve seçenekler ekranda durabiliyorsa
- * çip grubu kullanılır: kullanıcı listeyi <em>açmadan</em> hem seçenekleri hem
- * de hangisinin seçili olduğunu görür — açılır listede bu bilgi iki tıklama
- * arkasındadır. 5–20 seçenek için {@link Select}, 20+ için {@link Combobox}.
- *
- * <h3>Tek seçim radyo grubudur</h3>
- * Tek seçimli grup `role="radiogroup"` alır ve çipler `role="radio"` olur.
- * Görsel olarak radyo düğmesi gibi durmasalar da davranış aynıdır; ekran
- * okuyucu "3 seçenekten 2.'si" diye okur. Yalnız `aria-pressed` kullanmak,
- * seçeneklerin birbirini dışladığı bilgisini kaybettiriyordu.
- *
- * <h3>Gezinme tabindex'i dolaşır (roving tabindex)</h3>
- * Radyo grubunda Tab tuşu <strong>gruba</strong> girer, seçenekler arasında ok
- * tuşlarıyla gezilir. Her çipin ayrı ayrı Tab durağı olması, 7 seçenekli bir
- * filtrede klavye kullanıcısını 7 kez Tab'lamaya zorluyordu.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`ArrowRight` / `ArrowDown`</td><td>sonraki seçenek; uçlarda DÖNER</td></tr>
- *   <tr><td>`ArrowLeft` / `ArrowUp`</td><td>önceki seçenek</td></tr>
- * </table>
- * ÇOKLU seçimde ok tuşu YOKTUR: orada her çip bağımsız bir onay kutusu ve
- * `Tab` ile gezilir — ok tuşuyla gezinmek seçimi de değiştirirdi, oysa
- * radyo grubunun aksine burada gezinmek seçmek demek değil. Nöbetçi:
- * `components/__tests__/keyboard.test.tsx`.
- */
+/** Çip grubu — açılır liste yerine tek dokunuşla seçim. */
 declare const ChipGroup_2: <T extends string>({ options, label, size, isScrollable, className, ...selection }: Props_6<T>) => JSX.Element;
 
 export declare type ChipOption<T extends string = string> = {
@@ -624,65 +348,10 @@ declare type CircleProps = {
 
 export declare const Combobox: typeof Combobox_2;
 
-/**
- * Aranabilir seçim kutusu.
- *
- * <h3>Neden yerel `<select>` değil</h3>
- * Yerel açılır liste 20 seçeneğe kadar iyidir. Binlerce seçenekli bir listede
- * kullanıcı harf harf yazarak (ve yalnızca baştan eşleşerek) arıyor, mobilde
- * ise metrelerce süren bir tekerlek çeviriyor. Aranabilir liste, seçeneği
- * <em>yazarak</em> bulmayı mümkün kılar.
- *
- * <h3>Arama kutusu listenin İÇİNDE</h3>
- * Arama alanını listenin dışına koymak kullanıcıya iki ayrı alan gösteriyor
- * ve hangisinin seçimi belirlediği anlaşılmıyordu. Tek tetikleyici, tek
- * panel: masaüstünde panel açılınca odak doğrudan arama kutusuna gider,
- * yazılır, Enter'a basılır. Dar ekranda odak VERİLMEZ — bkz. aşağıdaki not.
- *
- * <h3>Yerel mi sunucu araması mı</h3>
- * `onSearch` verilmezse bileşen elindeki listeyi aksan duyarsız filtreler.
- * Verilirse filtrelemeyi <em>yapmaz</em> — sunucudan gelen liste zaten
- * filtrelenmiştir; ikinci kez filtrelemek sunucunun daha akıllı eşleşmesini
- * (eş anlamlı, kod eşleşmesi) bozardı.
- *
- * <h3>Seçilenin etiketi listeden düşse de korunur</h3>
- * Sunucu aramasında kullanıcı yeni bir arama yaptığında seçili kayıt gelen
- * listede olmayabilir. Etiket son bilinen değerden hatırlanır; aksi hâlde
- * tetikleyici seçim varken yer tutucuya dönüyordu.
- *
- * <h3>Dar ekranda arama kutusu ODAKLANMAZ</h3>
- * Alt sayfa açılırken kutuya odaklanmak ekran klavyesini kullanıcı istemeden
- * açıyordu: panel yarı yüksekliğe sıkışıyor, liste birkaç satıra iniyor ve
- * seçim yapmak için önce klavyeyi kapatmak gerekiyordu. Telefonda liste
- * taranarak kullanılır; yazmak isteyen kutuya kendisi dokunur.
- *
- * <h3>ARIA</h3>
- * Tetikleyici `aria-haspopup="listbox"`, panel içindeki arama alanı
- * `role="combobox"` + `aria-activedescendant`. Masaüstünde odak arama
- * kutusundan ayrılmaz; ok tuşları yalnızca <em>etkin</em> seçeneği değiştirir.
- * Odağı seçeneklere taşımak, yazmaya devam etmeyi imkânsız kılıyordu.
- *
- * <h3>Klavye (APG: combobox with listbox popup)</h3>
- * <table>
- *   <tr><td>`ArrowDown` / `ArrowUp`</td><td>etkin seçenek bir alt/üst; uçlarda DÖNER</td></tr>
- *   <tr><td>`Home` / `End`</td><td>ilk / son seçenek</td></tr>
- *   <tr><td>`Enter`</td><td>etkin seçeneği seçer, paneli kapatır</td></tr>
- *   <tr><td>`Escape`</td><td>kapatır, odak tetikleyiciye döner</td></tr>
- *   <tr><td>`Tab`</td><td>kapatır, gezinme sürer</td></tr>
- *   <tr><td>yazmak</td><td>filtreler ve etkin seçeneği başa çeker</td></tr>
- * </table>
- * Nöbetçi: `components/__tests__/keyboard.test.tsx`.
- */
-declare const Combobox_2: <T extends string>({ options, value, onChange, labels, isSearchHidden, onSearch, isLoading, isDisabled, isClearable, icon, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_7<T>) => JSX.Element;
+/** Aranabilir seçim kutusu. */
+declare const Combobox_2: <T extends string>({ options, value, onChange, labels, isSearchHidden, onSearch, isLoading, isDisabled, isClearable, icon, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: ComboboxProps<T>) => JSX.Element;
 
-/**
- * Bileşenin çizdiği metinler.
- *
- * <p>`placeholder` dışındaki her şey `HanuiProvider labels.combobox`ten de
- * gelebilir; buradaki değer kazanır. `placeholder` ALANI adlandırır
- * ("Şehir seçin", "Marka seçin") ve her çağrı yerinde farklıdır — o yüzden
- * zorunlu kaldı.
- */
+/** Bileşenin çizdiği metinler. */
 export declare type ComboboxLabels = {
     /** Seçim yokken tetikleyicide ve alt sayfa başlığında görünen metin. */
     placeholder: string;
@@ -706,6 +375,32 @@ export declare type ComboboxOption<T extends string = string> = {
     isDisabled?: boolean;
 };
 
+declare type ComboboxProps<T extends string> = {
+    options: ComboboxOption<T>[];
+    value: T | null;
+    onChange: (value: T | null) => void;
+    labels: ComboboxLabels;
+    /**
+     * Verilirse arama <strong>sunucuda</strong> yapılır: bileşen listeyi kendisi
+     * filtrelemez, yazılanı 300 ms bekleyip buraya bildirir. Verilmezse
+     * filtreleme yerelde ve aksan duyarsız yapılır.
+     */
+    onSearch?: (query: string) => void;
+    isLoading?: boolean;
+    isDisabled?: boolean;
+    /** Seçimi kaldıran çarpı düğmesi gösterilir. */
+    isClearable?: boolean;
+    /** Arama kutusu GİZLENİR. */
+    isSearchHidden?: boolean;
+    /** Tetikleyicinin solundaki ikon. */
+    icon?: ReactNode;
+    id?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+    className?: string;
+    testId?: string;
+};
+
 export declare type CommandItem = {
     id: string;
     label: string;
@@ -721,78 +416,17 @@ export declare type CommandItem = {
 
 export declare const CommandPalette: typeof CommandPalette_2;
 
-/**
- * Komut paleti — klavyeyle her şeye ulaşma.
- *
- * <h3>Neden `Combobox` + `Modal` bileşimi DEĞİL de ayrı bir bileşen</h3>
- * Denendi ve iki yerde kırıldı. `Combobox` bir DEĞER seçtiriyor: seçim
- * tetikleyicide kalıcı olarak görünüyor, `value`/`onChange` sözleşmesi var ve
- * kapanınca seçili öğe hatırlanıyor. Palet ise bir EYLEM çalıştırıyor —
- * hatırlanacak bir değer yok. İkincisi, `Combobox`ın tetikleyicisi var;
- * palette tetikleyici KLAVYE KISAYOLU ve o kısayolu bağlamak çağıranın işi
- * (hangi tuş, hangi sayfada — kütüphane bilemez).
- *
- * <h3>Kısayolu KÜTÜPHANE bağlamaz</h3>
- * `⌘K` yaygın ama evrensel değil ve belge düzeyinde bir tuş dinleyicisi
- * kurmak, tüketicinin kendi kısayollarıyla sessizce çakışmak demek. `shortcut`
- * alanı yalnızca GÖSTERİLİYOR; `isOpen` çağıranın.
- *
- * <h3>Arama `matchesSearch` ile — aksan duyarsız</h3>
- * "siparis" yazan kullanıcı "Sipariş"i bulmalı. Aynı normalizasyon
- * `Combobox`ın yerel filtresinde de kullanılıyor; iki yerde iki farklı arama
- * kuralı, aynı terimin iki farklı sonuç vermesi demekti.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`ArrowDown` / `ArrowUp`</td><td>etkin komut; uçlarda DÖNER</td></tr>
- *   <tr><td>`Home` / `End`</td><td>ilk / son komut</td></tr>
- *   <tr><td>`Enter`</td><td>etkin komutu çalıştırır ve kapatır</td></tr>
- *   <tr><td>`Escape`</td><td>kapatır, odak AÇAN öğeye döner</td></tr>
- * </table>
- * Odak arama kutusundan AYRILMAZ; etkin komut `aria-activedescendant` ile
- * bildiriliyor. Odağı listeye taşımak yazmaya devam etmeyi imkânsız
- * kılıyordu.
- */
+/** Komut paleti — klavyeyle her şeye ulaşma. */
 declare const CommandPalette_2: ({ isOpen, onClose, items, label, searchPlaceholder, emptyMessage, className, testId, }: Props_42) => JSX.Element;
 
-/**
- * Her bileşenin kabul ettiği ortak kanca noktaları.
- *
- * <p>`testId` `data-testid` olarak çizilir. Test kancasını prop olarak
- * geçirmek yerine `className`e bir işaret koymak da mümkündü ama sınıf adları
- * derleme sırasında karıştırılıyor: testin ona tutunması, kütüphane sürüm
- * atladığında sessizce kopuyordu.
- */
+/** Her bileşenin kabul ettiği ortak kanca noktaları. */
 export declare type CommonElementProps = Partial<{
     className: string;
     id: string;
     testId: string;
 }>;
 
-/**
- * YOĞUN (compact) KİP — `<html data-hanui-density="compact">`.
- *
- * <h3>Gerekçe ölçülü</h3>
- * Aynı bileşenleri iki uygulama kullanıyor: vitrin bir ekranda 8 satır,
- * operasyon paneli 80 satır gösteriyor. Vitrin için doğru olan ferahlık,
- * panelde kullanıcıyı kaydırmaya mahkûm ediyor; panel için doğru olan
- * sıkılık vitrinde ucuz duruyor. İkisini tek ölçekle karşılamanın yolu yok.
- *
- * <h3>Boşluk ve punto iner; yarıçap ve dokunma hedefi inmez</h3>
- * `space-0` ve `space-1` sabit kalır: 4 px'in altına inen bir boşluk kademesi
- * bir boşluk değil bir çizim hatası. Yarıçap da sabit kalır — yuvarlaklık
- * yoğunluğun değil markanın işi.
- *
- * <p>Punto ölçeğinin <strong>tamamı</strong> iner. Bir dönem yalnızca küçük
- * uç (`2xs`–`body`) iniyordu ve bu ölçülebilir bir hataydı: gövde 15 px'e
- * inerken başlıklar 29 px'te kaldığı için oran vitrindekinin çok üstüne
- * çıkıyor, panelde başlıklar ekranı yiyordu.
- *
- * <h3>DOKUNMA HEDEFİ KÜÇÜLMEZ</h3>
- * `tap-target` görünmez bir örtü çiziyor ve ölçüsü (44 px) buraya girmiyor:
- * yoğun kip bilgi yoğunluğunu artırmak içindir, dokunulabilirliği düşürmek
- * için değil (WCAG 2.5.8). Görsel kutu küçülür, hedef küçülmez.
- */
+/** YOĞUN (compact) KİP — `<html data-hanui-density="compact">`. */
 export declare const COMPACT_DENSITY: {
     readonly 'space-2': "6px";
     readonly 'space-3': "8px";
@@ -819,41 +453,8 @@ export declare const ConfirmDialog: typeof ConfirmDialog_2;
 /**
  * Onay penceresi.
  *
- * <h3>Neden `window.confirm()` yerine bu</h3>
- * Yerel `confirm()`in dört sorunu var:
- * <ul>
- *   <li>Görünümü işletim sisteminin — sitenin diliyle hiç ilgisi yok, üstünde
- *       tarayıcının alan adı yazıyor.</li>
- *   <li><strong>Ana iş parçacığını kilitler.</strong></li>
- *   <li>Yıkıcı eylemi vurgulayamaz: "Tamam" ile "İptal" aynı ağırlıkta ve
- *       hangisinin sildiğini yalnızca metinden anlıyorsun.</li>
- *   <li>İstek sürerken geri bildirim veremez; kullanıcı silme düğmesine ikinci
- *       kez basıyordu.</li>
- * </ul>
- *
- * <h3>Yükleme durumu pencerede kalır</h3>
- * Onaya basıldığında pencere hemen kapanmaz: düğme yükleniyor durumuna geçer
- * ve pencere kapanmaz hâle gelir (`isDismissable={false}`). İstek bittiğinde
- * kapatma kararı çağırana ait — hata varsa pencere açık kalmalı ki kullanıcı
- * tekrar deneyebilsin.
- *
  * @example
  * const [target, setTarget] = useState<Address | null>(null);
- *
- * <ConfirmDialog
- *   isOpen={target !== null}
- *   onClose={() => setTarget(null)}
- *   kind="destructive"
- *   title="Adres silinsin mi?"
- *   description="Bu işlem geri alınamaz."
- *   confirmLabel="Sil"
- *   cancelLabel="Vazgeç"
- *   closeLabel="Kapat"
- *   onConfirm={async () => {
- *     await remove(target!.id);
- *     setTarget(null);
- *   }}
- * />
  */
 declare const ConfirmDialog_2: FC<Props_43>;
 
@@ -861,38 +462,7 @@ export declare type ConfirmKind = 'destructive' | 'warning' | 'neutral';
 
 export declare const CopyField: typeof CopyField_2;
 
-/**
- * Kopyalanabilir teknik değer — <strong>tek dokunuşla panoya</strong>.
- *
- * <h3>Neden ayrı bir öğe</h3>
- * Bir kod (SKU, parça numarası, sipariş numarası, IBAN) dekoratif bir metin
- * değil, kullanıcının <em>taşıdığı</em> veri. Düz bir `<span>` olduğunda
- * kullanıcı onu fareyle seçmeye çalışırken kartın tamamını seçiyor ya da
- * yanlışlıkla altındaki bağlantıyı tetikliyordu.
- *
- * <h3>Neden monospace</h3>
- * "0986479644" gibi diziler orantılı yazı tipinde okunmuyor: `0`/`O` ve `1`/`l`
- * ayırt edilemiyor ve bir hane atlandığında tamamen başka bir kayıt oluyor.
- * `technical-text` sabit genişlik + `tabular-nums` verir; iki değer alt alta
- * geldiğinde farklı hane gözle bulunur.
- *
- * <h3>Geri bildirim neden düğmenin üstünde</h3>
- * Bir bildirim (toast) da olurdu ama listelerde on beş satır var; ekranın
- * dibinde "kopyalandı" yazması <em>hangisinin</em> kopyalandığını
- * söylemiyordu. İkon yerinde tike dönünce cevap tıklanan yerde.
- *
- * <h3>Düğmede native `title` YOK</h3>
- * Ad yalnızca `aria-label`da. `title` aynı metni bir kez daha yazıyordu ve
- * tarayıcı balonu dokunmatikte hiç görünmediği için hiçbir şey kazandırmıyor,
- * bazı ekran okuyucularda adı iki kez okutuyordu. Simgenin kendisi zaten bir
- * pano ve kopyalandığında tikli panoya dönüyor.
- *
- * <h3>Pano erişimi reddedilirse</h3>
- * `navigator.clipboard` güvenli olmayan bağlamda (HTTP) ve izin verilmediğinde
- * reddeder. O durumda değer sessizce <em>seçilir</em>: kullanıcı Ctrl+C ile
- * kendisi kopyalayabilir. Sessizce hiçbir şey yapmamak, düğmeyi bozuk
- * gösteriyordu.
- */
+/** Kopyalanabilir teknik değer — <strong>tek dokunuşla panoya</strong>. */
 declare const CopyField_2: FC<Props_22>;
 
 export declare type Crumb = {
@@ -901,41 +471,12 @@ export declare type Crumb = {
     href?: string;
 };
 
-/**
- * KOYU TEMA.
- *
- * <p>Yüzey merdiveni açık temanın AYNISI DEĞİL, tersi: koyu temada yükselen
- * yüzey AÇILIR (`surface` > `page`), çünkü ışık yukarıdan gelir. Aynı sırayı
- * korumak kartları sayfaya gömüyordu.
- */
+/** KOYU TEMA. */
 export declare const DARK_THEME: Record<keyof typeof LIGHT_THEME, string>;
 
 export declare const DataTable: typeof DataTable_2;
 
-/**
- * Operasyon veri tablosu — durum satırlı tablo sözleşmesi.
- *
- * <h3>Neden bir bileşen</h3>
- * On iki ekranda on bir ham tablo ve altı kaydırma sarmalayıcısı kopyası
- * vardı; üçü farklı davranıyordu (kimi dikey kaymıyor, kiminin başlığı
- * yapışmıyor). Kabuk (yüzey + hairline + `overflow: auto`), tablo görünümü ve
- * üç durum satırı (yükleniyor / hata / boş) artık tek yerde; `colSpan` sütun
- * sayısından kendiliğinden hesaplanır — elle yazılan `colSpan={8}` bir sütun
- * eklenince sessizce yanlış kalıyordu.
- *
- * <h3>Durum öncelik sırası</h3>
- * `error` &gt; `isLoading` &gt; boş &gt; satırlar. Hata varken yükleme veya boş
- * mesajı gösterilmez; yüklenirken bayat satır çizilmez.
- *
- * <h3>Görünmez başlık `aria-label` DEĞİL, gizlenmiş METİN</h3>
- * Eylem sütununun adı önce `<th aria-label="Eylemler">` olarak yazılıyordu.
- * Eksen taraması bunu ihlal olarak bildirdi (`empty-table-header`) ve haklı:
- * `aria-label`ın hücre başlığı olarak kullanılması destek teknolojilerinde
- * tutarsız — bazı ekran okuyucular tablo gezinme kipinde sütun adını
- * hücrenin İÇERİĞİNDEN okur ve boş bir `<th>` orada adsız kalır. Görsel olarak
- * gizlenmiş gerçek bir metin düğümü hem okunur hem de sayfa çevirisine,
- * bulma-değiştirmeye ve seçime dahil olur.
- */
+/** Operasyon veri tablosu — durum satırlı tablo sözleşmesi. */
 declare const DataTable_2: FC<Props_47>;
 
 export declare type DataTableColumn = {
@@ -946,18 +487,9 @@ export declare type DataTableColumn = {
     /**
      * Görsel başlığı olmayan sütunun erişilebilir adı (eylem sütunu gibi).
      * Boş bir `<th>` ekran okuyucuda adsız bir sütun bırakıyordu.
-     *
-     * <p>Metin `aria-label` OLARAK DEĞİL, görsel olarak gizlenmiş gerçek bir
-     * metin düğümü olarak yazılır — gerekçe {@link DataTable} JSDoc'unda.
      */
     srLabel?: string;
-    /**
-     * Sıralanabilir sütunun yönü (`aria-sort`).
-     *
-     * <p>`onSort` ile birlikte verildiğinde başlık TIKLANABİLİR olur ve yön
-     * oku çizilir. Tek başına verildiğinde yalnızca durumu bildirir —
-     * sıralamayı başka bir denetim (bir `Select`) yapıyorsa doğrusu budur.
-     */
+    /** Sıralanabilir sütunun yönü (`aria-sort`). */
     ariaSort?: 'ascending' | 'descending';
     /**
      * Sütun sıralanabilir. `DataTable.onSort` ile birlikte anlamlı; ikisinden
@@ -965,14 +497,7 @@ export declare type DataTableColumn = {
      * yapmayan bir başlık, kullanıcıya var olmayan bir yetenek vaat ediyordu.
      */
     isSortable?: boolean;
-    /**
-     * Sütun yatay kaydırmada YERİNDE kalır.
-     *
-     * <p>Yalnızca İLK sütunda anlamlı: geniş bir tabloda sağa kaydıran
-     * kullanıcı hangi satıra baktığını kaybediyordu. İkinci bir yapışkan sütun
-     * `left` ofsetinin elle hesaplanmasını gerektirir ve o hesap sütun
-     * genişliğine bağlı — desteklenmiyor.
-     */
+    /** Sütun yatay kaydırmada YERİNDE kalır. */
     isSticky?: boolean;
     className?: string;
 };
@@ -981,40 +506,7 @@ export declare const DataTableRow: FC<RowProps>;
 
 export declare const DateField: typeof DateField_2;
 
-/**
- * Tarih alanı — <strong>yerel</strong> `<input type="date">`.
- *
- * <h3>Neden taklit bir takvim YOK</h3>
- * Bu kütüphanenin kuralı: yerel öğe korunur, taklit yazmanın tek gerekçesi
- * ölçülmüş bir kusurdur ({@link Select} bunun tek istisnası ve gerekçesi
- * orada yazılı). Tarih alanında böyle bir kusur YOK — tersine, yerel öğenin
- * taklidin veremeyeceği dört şeyi var:
- *
- * <ul>
- *   <li><b>Mobilde işletim sisteminin seçicisi.</b> iOS'ta tekerlek, Android'de
- *       takvim — kullanıcının her gün kullandığı, alışkın olduğu arayüz. Hiçbir
- *       web takvimi 360 px'lik bir ekranda ona yaklaşamıyor.</li>
- *   <li><b>Klavyeyle YAZARAK giriş.</b> Doğum tarihini bilen biri "01.01.1980"i
- *       üç saniyede yazıyor; taklit takvimde aynı iş kırk yıl geriye tıklamak
- *       demek.</li>
- *   <li><b>Yerel biçim.</b> Tarayıcı kullanıcının işletim sistemi ayarına göre
- *       gg.aa.yyyy ya da mm/dd/yyyy gösteriyor; değer her zaman ISO
- *       (`YYYY-MM-DD`) kalıyor. İki biçimi elle yönetmek, kütüphanenin
- *       kullanıcının yerel ayarını TAHMİN etmesi demekti.</li>
- *   <li><b>Ekran okuyucu.</b> Alan üç ayrı bölüm (gün/ay/yıl) olarak okunuyor
- *       ve ok tuşlarıyla artırılıyor. APG'ye uygun bir takvim ızgarası bunu
- *       ancak taklit edebilir.</li>
- * </ul>
- *
- * <p>Bedeli: takvim açılışının görünüşü tarayıcıya ait ve tema token'larını
- * izlemiyor. Kabul edildi — açılan panelin rengi, yukarıdaki dördünün
- * yanında küçük bir bedel.
- *
- * <h3>`min` / `max` KULLANIN</h3>
- * İkisi de yerel öğede var ve tarayıcı doğrulamayı kendisi yapıyor. Geçersiz
- * bir tarihi yalnızca gönderimde yakalamak, kullanıcıyı formu doldurduktan
- * sonra geri gönderiyordu.
- */
+/** Tarih alanı — <strong>yerel</strong> `<input type="date">`. */
 declare const DateField_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
 /** `date` (varsayılan) · `datetime-local` · `month` · `time`. */
 type?: "date" | "datetime-local" | "month" | "time";
@@ -1037,30 +529,16 @@ export declare const Directory: typeof Directory_2;
 /**
  * Dizin — harf veya konu başlıklı, gruplanmış bağlantı listesi.
  *
- * <h3>Neden ortak bir bileşen</h3>
- * Bir marka dizini ile bir kategori dizini aynı işi yapıyor: yüzlerce
- * bağlantıyı gruplayıp taranabilir kılmak. Ama iki container bunu ayrı ayrı
- * kurmuştu ve sonuç iki farklı sayfa oldu — birinde grup başlığı alt çizgili
- * 19 px, diğerinde çizgisiz; birinde satırlar ızgarada, diğerinde tek kolonda.
- *
- * <p>Ortak olan <em>görsel dilbilgisi</em>: grup başlığı + ızgara + satır
- * öğesi. O buraya taşındı; ne listelendiği çağırana kaldı.
- *
  * @example
  * <Directory>
- *   <DirectoryGroup label="A">
- *     <DirectoryRow href="/marka/ate" name="ATE" media={<img … />} />
- *   </DirectoryGroup>
+ * <DirectoryGroup label="A">
+ * <DirectoryRow href="/marka/ate" name="ATE" media={<img … />} />
+ * </DirectoryGroup>
  * </Directory>
  */
 declare const Directory_2: FC<DirectoryProps>;
 
-/**
- * Dizin grubu.
- *
- * <p>Başlık <strong>yapışkan</strong>: uzun bir listede kaydırırken hangi
- * harfte olduğunu görmek, listeyi yukarı sarıp kontrol etmekten iyi.
- */
+/** Dizin grubu. */
 export declare const DirectoryGroup: FC<DirectoryGroupProps>;
 
 declare type DirectoryGroupProps = {
@@ -1080,17 +558,7 @@ declare type DirectoryGroupProps = {
     id?: string;
 };
 
-/**
- * Alfabe atlama şeridi.
- *
- * <p>Uzun bir listede "V" harfine ulaşmak için kaydırmak dakikalar alıyordu.
- * Şerit yatay kayar ve `#çıpa` bağlantıları taşır — JavaScript gerekmez,
- * tarayıcı kaydırmayı kendisi yapar ve bağlantı paylaşılabilir.
- *
- * <p>Bağlantılar HAM `<a>`: bunlar sayfa içi çıpa, gezinme değil. Bir
- * yönlendiriciden geçirmek aynı sayfayı yeniden çözümleyip kaydırmayı
- * kaçırıyordu.
- */
+/** Alfabe atlama şeridi. */
 export declare const DirectoryJump: FC<DirectoryJumpProps>;
 
 declare type DirectoryJumpProps = {
@@ -1107,13 +575,7 @@ declare type DirectoryProps = {
     className?: string;
 };
 
-/**
- * Dizin satırı — tek bir bağlantı.
- *
- * <p>Tüm satır tıklanabilir ve en az 44 px yüksekliğinde (WCAG 2.5.8):
- * yalnızca metnin tıklanabilir olduğu bir listede dokunmatik kullanıcılar
- * satırın boşluğuna basıp hiçbir şey olmadığını görüyordu.
- */
+/** Dizin satırı — tek bir bağlantı. */
 export declare const DirectoryRow: FC<DirectoryRowProps>;
 
 declare type DirectoryRowProps = {
@@ -1130,68 +592,17 @@ declare type DirectoryRowProps = {
 
 export declare const Divider: typeof Divider_2;
 
-/**
- * Ayırıcı çizgi.
- *
- * <p>Etiketli hâli `role="separator"` taşımaz: metin içerdiğinde ekran okuyucu
- * onu ayırıcı değil içerik olarak okumalı ("veya").
- */
+/** Ayırıcı çizgi. */
 declare const Divider_2: FC<Props_23>;
 
 export declare const Drawer: typeof Drawer_2;
 
-/**
- * Çekmece (drawer) — kenardan açılan kipsel panel.
- *
- * <h3>{@link BottomSheet} ile farkı: EKRAN, tercih değil</h3>
- * İkisi de kipsel bir yan panel; ayrım hangi ekranda doğru olduklarında:
- *
- * <ul>
- *   <li>`BottomSheet` DAR ekran içindir. Baş parmağın erişebildiği yer
- *       ekranın dibi; kenardan gelen bir panel telefonda ekranın tamamını
- *       kaplıyor ve "panel" olmaktan çıkıyor.</li>
- *   <li><b>`Drawer` GENİŞ ekran içindir.</b> Filtre paneli ve ayrıntı
- *       incelemesi sayfanın yanında durur; kullanıcı listeyi görmeye devam
- *       eder. Aynı panel dipten gelseydi 1440 px'lik bir ekranda içeriğin
- *       tamamını örtüyordu.</li>
- * </ul>
- *
- * <h3>`isOpen` alır — ve bu {@link BottomSheet}ten bilinçli bir AYRILIK</h3>
- * `BottomSheet` "açıkken çizilir, kapatmak için kaldırılır" sözleşmesini
- * kullanıyor ve bunun bir bedeli var: React sökülen bir ağacı bekletmediği
- * için <strong>çıkış animasyonu çizilemiyor</strong>, panel bir karede yok
- * oluyor. Çekmece açık/kapalı durumu kendisi taşıyor; `<dialog>` kapanırken
- * `@starting-style` + `allow-discrete` ile geri kayıyor.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Escape`</td><td>kapatır — üst üste açık panellerde YALNIZCA en üstteki</td></tr>
- *   <tr><td>`Tab`</td><td>odak panelin içinde döner (tarayıcı: `showModal()`)</td></tr>
- * </table>
- * Açılışta odak kapatma düğmesine DEĞİL ilk anlamlı öğeye gider.
- */
+/** Çekmece (drawer) — kenardan açılan kipsel panel. */
 declare const Drawer_2: ({ isOpen, onClose, title, closeLabel, children, side, size, footer, toolbar, className, testId, }: Props_44) => JSX.Element;
 
 export declare const EmptyState: typeof EmptyState_2;
 
-/**
- * Boş durum.
- *
- * <h3>Neden her boş durum bir eylem taşır</h3>
- * "Sonuç bulunamadı" tek başına çıkmaz sokaktır. Kullanıcı o ekranda ne
- * yapacağını bilmeli: aramayı temizle, filtreyi kaldır, listeye dön. `action`
- * isteğe bağlı ama çağıran taraf onu vermezse kullanıcı tıkanır.
- *
- * <h3>BOŞ ile YÜKLENEMEDİ ayrı durumlardır</h3>
- * Ağ hatasını "kayıt kalmamış" diye okuyan kullanıcı yanlış karar veriyor.
- * İkisi `tone` ile ayrılıyor: `error` farklı bir ton taşıyor ve
- * `role="alert"` ile duyuruluyor, ama YERLEŞİM aynı — iki durum arasındaki
- * geçiş sıçramıyor.
- *
- * <p>Ayrım önce bu bileşenin DIŞINDAYDI ("ağ hatasında çizilmez") ve sonucu
- * şuydu: her çağıran kendi hata kutusunu yazıyor, kutular birbirinden farklı
- * görünüyordu. Ayrım korunuyor, kararın yeri değişti.
- */
+/** Boş durum. */
 declare const EmptyState_2: FC<Props_24>;
 
 export declare const Field: typeof Field_2;
@@ -1199,21 +610,9 @@ export declare const Field: typeof Field_2;
 /**
  * Form alanı sarmalayıcısı.
  *
- * <h3>Neden render-prop</h3>
- * Etiket, hata mesajı ve yardım metni girdiye `id` / `aria-describedby` /
- * `aria-invalid` ile <strong>bağlanmak zorunda</strong> — yoksa ekran okuyucu
- * hatayı okumaz. Bu bağları her form alanında elle yazmak kaçınılmaz olarak
- * bir yerde atlanıyor.
- *
- * <p>Render-prop kalıbı bağları bileşene ürettirir: çağıran taraf yalnızca
- * aldığı props'ları girdiye yayar ve erişilebilirlik kendiliğinden doğru olur.
- *
- * <p>Hata varken yardım metni gösterilmez: ikisi birlikte gürültü yapar ve
- * kullanıcının okuması gereken mesaj kaybolur.
- *
  * @example
  * <Field label="E-posta" isRequired requiredLabel="(zorunlu)" error={emailError}>
- *   {props => <Input {...props} type="email" value={email} onChange={onChange} />}
+ * {props => <Input {...props} type="email" value={email} onChange={onChange} />}
  * </Field>
  *
  * @example
@@ -1242,65 +641,12 @@ declare type FieldProps = {
 
 export declare const FileUpload: typeof FileUpload_2;
 
-/**
- * Dosya yükleme — sürükle-bırak <strong>ve</strong> düğme.
- *
- * <h3>Yerel `<input type="file">` KORUNUR</h3>
- * Görsel olarak gizlenir ama DOM'da kalır ve `<label>` ile alana bağlanır:
- * klavyeyle `Tab` + `Enter`, ekran okuyucuda "dosya seç, düğme" duyurusu,
- * işletim sisteminin dosya seçicisi ve mobilde kamera/galeri seçenekleri
- * <em>bedava</em> gelir. `<div>` üzerine `onDrop` yazıp düğmeyi taklit etmek
- * bunların hiçbirini getirmiyor — ve sürükle-bırak zaten <strong>tek başına
- * erişilebilir değil</strong>: fare gerektiriyor (WCAG 2.5.7).
- *
- * <h3>Doğrulama BİLEŞENDE, ama yalnızca ÖLÇÜLEBİLİR olan</h3>
- * Boyut sınırı burada uygulanıyor çünkü cevabı kesin ve anında verilebiliyor:
- * aşan dosya `onSelect`e hiç ulaşmıyor, kullanıcı yüklemenin bitmesini
- * beklemeden hatayı görüyor. Tür/içerik doğrulaması burada YAPILMIYOR —
- * `accept` bir öneri, gerçek karar sunucunun ve istemcide "geçerli" demek
- * yanlış bir söz olurdu.
- *
- * <h3>Sonuç DUYURULUYOR</h3>
- * Dosya eklendiğinde ve reddedildiğinde `useAnnounce` ile ekran okuyucuya
- * bildiriliyor. Listeye sessizce eklenen bir satır, görmeyen kullanıcı için
- * hiç olmamış demekti.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Tab`</td><td>alana, sonra her dosyanın kaldırma düğmesine</td></tr>
- *   <tr><td>`Enter` / `Space`</td><td>alanda: dosya seçiciyi açar</td></tr>
- * </table>
- */
+/** Dosya yükleme — sürükle-bırak <strong>ve</strong> düğme. */
 declare const FileUpload_2: ({ files, onSelect, onRemove, label, hint, accept, isMultiple, maxSize, removeLabel, dropLabel, sizeErrorText, isDisabled, error, children, className, testId, }: Props_16) => JSX.Element;
 
 export declare const FilterBar: typeof FilterBar_2;
 
-/**
- * Filtre şeridi.
- *
- * <h3>Her zaman `<form onSubmit>`</h3>
- * Beş ekran şeridi elle kuruyordu ve yalnızca üçü `<form>` kullanıyordu: arama
- * kutusunda Enter üç ekranda filtreyi uyguluyor, ikisinde hiçbir şey
- * yapmıyordu. Şerit artık her zaman bir formdur ve görünür bir gönderme düğmesi
- * olmasa bile Enter çalışsın diye gizli bir yedek gönderme düğmesi taşır
- * (birden çok alanı olan formda tarayıcının örtük gönderimi ancak bir gönderme
- * düğmesi varsa çalışır).
- *
- * <h3>Denetimler tek hizada</h3>
- * Şerit alanları alt kenardan hizalar; etiketli ve etiketsiz alanın yan yana
- * durması bunu bozmaz. Bozan şey denetimin <strong>altına</strong> yazılan
- * yardım/hata metniydi: alanın alt kenarı artık denetimin değil metnin kenarı
- * oluyor ve denetim komşularından yukarı kaçıyordu (ölçüldü: bir ekranda 24 px
- * kaçık iki girdi). Şeridin içindeki `Field` mesajı denetimin
- * <em>üstüne</em> alır — etiket, ipucu, denetim. DOM sırası değişmez, yani
- * ekran okuyucu yine "etiket, denetim, hata, ipucu" duyar.
- *
- * <h3>320px'te taşma yok</h3>
- * Alanlar `min-width: 240–280px` taşıyordu ve en dar ekranda şerit sayfayı yana
- * kaydırıyordu. Genişlik artık `flex-basis` ile istenir, `min-width: 0` ile
- * daraltılabilir kalır: alan tercihen 220px'tir ama sığmadığı yerde küçülür,
- * taşmaz.
- */
+/** Filtre şeridi. */
 declare const FilterBar_2: FC<Props_48>;
 
 /**
@@ -1309,82 +655,20 @@ declare const FilterBar_2: FC<Props_48>;
  */
 export declare const FilterBarField: FC<FieldProps>;
 
-/**
- * ARAYÜZ METİNLERİ.
- *
- * <h3>Kütüphane hiçbir dilde metin UYDURMAZ</h3>
- * Bir bileşen kütüphanesi "Kapat" yazamaz: hangi dilde, hangi üslupta
- * ("Kapat" mı "Vazgeç" mi), hangi terimle (kayıt / ürün / talep) yazacağını
- * bilmez. Bu yüzden kullanıcıya görünen her metin dışarıdan gelir.
- *
- * <h3>Ama her ÇAĞRI YERİNDE değil, bir KEZ</h3>
- * Metinleri prop olarak zorunlu tutmak doğruydu ama yeri yanlıştı: aynı
- * "Kapat" dizesi yüz çağrı yerine dağılıyor ve biri değiştiğinde
- * doksan dokuzu eski kalıyordu. Uygulamanın dili tek; karar da tek yerde
- * verilmeli.
- *
- * <pre>
- * &lt;HanuiProvider labels={{ close: 'Kapat', cancel: 'Vazgeç' }}&gt;
- * </pre>
- *
- * <h3>Çözümleme sırası: prop → config → uyarı</h3>
- * Bir prop verilmişse o kazanır (bir pencerenin kapatma düğmesi bağlama göre
- * "Kapat" yerine "Daha sonra" olabilir). Verilmemişse config'ten okunur.
- * İkisi de yoksa öğe erişilebilir adını kaybeder — bu bir hata ve geliştirme
- * kipinde konsola yazılır (bkz. `helpers/label.helper`).
- *
- * <h3>Neden derleme zamanında zorlanamıyor</h3>
- * TypeScript, çalışma zamanında bir sağlayıcının olup olmadığını göremez.
- * Prop'ları zorunlu tutmak config'i işe yaramaz kılardı; isteğe bağlı yapmak
- * derleme güvencesini bırakıp geliştirme uyarısına indiriyor. Bilinçli bir
- * takas: metnin tek yerde durması, derleyicinin bunu görmesinden daha değerli.
- *
- * <h3>Neye metin VERİLMEZ</h3>
- * Öğeye ÖZGÜ olan hiçbir şey buraya girmez: `Modal.title`,
- * `ConfirmDialog.confirmLabel` ("Sil" — eylemi tekrarlamak zorunda),
- * `IconButton.label`, `Select.label`, `TableCheckbox.label`. Bunlar prop
- * olarak zorunlu kalır çünkü her çağrı yerinde farklıdır.
- */
 /** Sayı biçimlendiricileri: değere bağlı metinler dizeyle verilemez. */
 declare type Formatter<TArgs extends unknown[]> = (...args: TArgs) => string;
 
 /**
  * Kullanıcının SEÇİMİ. `system` = açık bir seçim yok, işletim sistemi tercihi
  * izlenir (`prefers-color-scheme`).
- *
- * <h3>Bu tip neden sonradan eklendi</h3>
- * `HanuiColorScheme`in JSDoc'u "`system` işletim sistemi tercihini izler"
- * diyordu ama tipte `system` YOKTU — belge bir yeteneği anlatıyor, tip onu
- * yasaklıyordu. İki çözüm vardı: cümleyi silmek ya da yeteneği gerçekten
- * eklemek. İkincisi seçildi çünkü eksik olan gerçek bir davranıştı: üç
- * durumlu tema anahtarı (Açık / Koyu / Sistem) yaygın bir kalıp ve kütüphane
- * onu kuramıyordu — `system`e dönmenin yolu özniteliği ELLE silmekti ve bunu
- * tüketicinin bilmesi gerekiyordu.
- *
- * <p>Ekleme KIRICI DEĞİL: `scheme` hâlâ çözülmüş değeri döndürüyor, yalnızca
- * `preference` alanı ve `setScheme('system')` girişi eklendi.
  */
 export declare type HanuiColorPreference = HanuiColorScheme | 'system';
 
-/**
- * ÇÖZÜLMÜŞ tema — ekranda gerçekten hangisi çizili.
- *
- * <p>Burada `system` YOKTUR ve olamaz: `system` bir tercih, bir tema değil.
- * Çözüldüğünde ya açık ya koyu olur ve bileşenlerin gördüğü şey o. İkisini tek
- * tipte toplamak, `scheme === 'system'` yazan bir tüketiciye hangi renklerin
- * çizildiğini hâlâ söylemiyordu.
- */
+/** ÇÖZÜLMÜŞ tema — ekranda gerçekten hangisi çizili. */
 export declare type HanuiColorScheme = 'light' | 'dark';
 
 export declare type HanuiContextValue = {
-    /**
-     * Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…).
-     *
-     * <p>Verilmezse ham `<a>` çizilir ve gezinme tam sayfa yenilemesi olur.
-     * Bir bileşen kütüphanesi kendi yönlendiricisini SEÇEMEZ: `next/link`
-     * import etmek paketi Next'e bağlar, `react-router` import etmek başka bir
-     * uygulamayı kırar. Karar tüketicinin.
-     */
+    /** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
     linkComponent?: HanuiLinkComponent;
     /** Uygulanan tema ezmeleri. Salt okunur; değiştirmek için `HanuiProvider`. */
     theme?: HanuiThemeConfig;
@@ -1395,27 +679,10 @@ export declare type HanuiContextValue = {
     labels?: HanuiLabels;
 };
 
-/**
- * Bilgi yoğunluğu. `default` vitrin, `compact` operasyon paneli.
- *
- * <p>Seçim `<html data-hanui-density>` ile taşınır — tıpkı tema gibi, ve aynı
- * sebeple: bir ölçek kararı tek bir React ağacının değil BELGENİN kararıdır;
- * portal ile gövdeye taşınan kip pencere de aynı yoğunlukta olmalı.
- */
+/** Bilgi yoğunluğu. `default` vitrin, `compact` operasyon paneli. */
 export declare type HanuiDensity = 'default' | 'compact';
 
-/**
- * Yazı tipi ailesi sözleşmesi.
- *
- * <p>Üç rol ayrı: başlık (≥19 px), arayüz metni (11–16 px) ve teknik veri
- * (kod, seri numarası, tutar). KÜÇÜK ARAYÜZ METNİ BAŞLIK FONTUNU KULLANMAZ —
- * grotesk başlık yüzleri 12–14 px yarı-kalında sıkışıp okunurluğu düşürüyor
- * ve düğme etiketleri bir arayüzün en çok okunan kısa metinleri.
- *
- * <p>Kütüphane font YÜKLEMEZ: değerler `font-family` dizesi olarak geçer ve
- * yüklemeyi (next/font, @font-face, CDN) tüketici yapar. Bir UI paketinin
- * ağdan font çekmesi, tüketicinin ölçemediği bir istek demek.
- */
+/** Yazı tipi ailesi sözleşmesi. */
 export declare type HanuiFonts = Partial<{
     heading: string;
     body: string;
@@ -1441,12 +708,11 @@ export declare type HanuiLabels = Partial<{
     directoryJump: string;
     /** Seçim yokken `Select` tetikleyicisinde görünen metin. */
     selectPlaceholder: string;
-    /**
-     * Baş harf büyütmesinde kullanılacak dil etiketi. `Avatar`.
-     *
-     * <p>Türkçede ZORUNLU: `toUpperCase()` "i" harfini "I" yapıyor ve
-     * "İlhan"ın baş harfi "I" çıkıyor.
-     */
+    /** Şifreyi görünür kılan düğmenin erişilebilir adı. `PasswordInput`. */
+    passwordShow: string;
+    /** Şifreyi gizleyen düğmenin erişilebilir adı. `PasswordInput`. */
+    passwordHide: string;
+    /** Baş harf büyütmesinde kullanılacak dil etiketi. `Avatar`. */
     locale: string;
     /** Para birimi simgesi ya da kodu. `Price`. */
     currency: string;
@@ -1507,19 +773,7 @@ export declare type HanuiLinkComponent = ComponentType<HanuiLinkProps>;
  */
 export declare type HanuiLinkExtraProps = Record<string, unknown>;
 
-/**
- * Kütüphanenin bir bağlantı bileşenine geçirdiği props.
- *
- * <p>`href` dize: yönlendirici nesnesi (`UrlObject`) alan bir Link'e de dize
- * geçilebiliyor, tersi doğru değil. En dar sözleşme en çok yönlendiriciyle
- * uyumlu olan.
- *
- * <p>İndeks imzası yönlendiriciye özgü ek props içindir (Next'in `scroll`,
- * `prefetch`i; React Router'ın `replace`i). Kütüphane onları tanımıyor ama
- * yolunu da kapatmamalı. Değer tipi `unknown`, `any` DEĞİL: `any` yazmak
- * yanlış bir prop'un tip denetiminden sessizce geçmesine izin verirdi.
- * `href` ve `children` açıkça bildirildiği için indeks imzasından etkilenmez.
- */
+/** Kütüphanenin bir bağlantı bileşenine geçirdiği props. */
 export declare type HanuiLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     href: string;
     children?: ReactNode;
@@ -1535,28 +789,9 @@ export declare type HanuiMetricToken = keyof typeof METRIC_TOKENS;
 /**
  * Kütüphane sağlayıcısı.
  *
- * <h3>İki iş yapar, üçüncüsünü YAPMAZ</h3>
- * <ol>
- *   <li>Tema ezmelerini belgeye yazar (`<style id="hanui-theme-overrides">`).</li>
- *   <li>Yönlendirici bileşenini bileşen ağacına dağıtır.</li>
- *   <li><strong>Açık/koyu seçimini YÖNETMEZ.</strong></li>
- * </ol>
- *
- * <h3>Neden tema seçimi burada değil</h3>
- * Seçim `<html data-hanui-theme>` üzerinde taşınır ve o özniteliğin
- * <em>boyamadan önce</em> yazılması gerekir: React ağacı monte olduktan sonra
- * yazıldığında koyu tema seçmiş kullanıcı bir kare beyaz ekran görüyor. Doğru
- * yer, sunucudan gelen HTML'in `<head>`ine konan satır içi bir betik — ve
- * oraya yazmak tüketicinin çatısının işi (Next'te `app/layout.tsx`, Vite'ta
- * `index.html`). Sağlayıcı ondan sonra monte oluyor; oraya koymak sorunu
- * çözmüyor, gizliyor.
- *
- * <p>`useHanuiTheme` kancası seçimi <em>değiştirmek</em> için var; ilk değeri
- * yazmak için değil. README "Tema" bölümünde hazır betik duruyor.
- *
  * @example
  * <HanuiProvider linkComponent={NextLink} theme={{ light: { blue: '#0d6efd' } }}>
- *   <App />
+ * <App />
  * </HanuiProvider>
  */
 export declare const HanuiProvider: FC<Props>;
@@ -1569,11 +804,11 @@ export declare type HanuiResolvedTokens = Record<HanuiToken, string>;
  *
  * @example
  * initHanui({
- *   theme: {
- *     light: { blue: '#0d6efd', 'blue-text': '#0a58ca' },
- *     dark:  { blue: '#6ea8fe' },
- *     fonts: { heading: 'Archivo, sans-serif' },
- *   },
+ * theme: {
+ * light: { blue: '#0d6efd', 'blue-text': '#0a58ca' },
+ * dark:  { blue: '#6ea8fe' },
+ * fonts: { heading: 'Archivo, sans-serif' },
+ * },
  * });
  */
 export declare type HanuiThemeConfig = Partial<{
@@ -1583,17 +818,32 @@ export declare type HanuiThemeConfig = Partial<{
     /**
      * Ölçü ezmeleri — yarıçap, boşluk, punto, süre.
      *
-     * <p>Renk gibi tema başına DEĞİL tek blokta: bir markanın yuvarlaklığı açık
-     * temada 12 px, koyu temada 8 px olmaz. Ayrı verilebilseydi iki değerin
-     * ayrışması kaçınılmazdı ve fark yalnızca tema değiştirildiğinde
-     * görünürdü — yani neredeyse hiç.
-     *
      * @example
      * initHanui({ theme: { metrics: { 'radius-md': '2px', 'radius-lg': '4px' } } });
      */
     metrics: HanuiMetrics;
 }>;
 
+declare type HanuiThemeState = {
+    /**
+     * ÇÖZÜLMÜŞ tema — ekranda çizili olan. `preference` `system` iken bu alan
+     * işletim sisteminin o anki tercihini taşır.
+     */
+    scheme: HanuiColorScheme;
+    /**
+     * Kullanıcının SEÇİMİ. Üç durumlu bir tema anahtarı (Açık / Koyu / Sistem)
+     * bunu okur; `scheme` okunsaydı "Sistem" seçiliyken düğme "Koyu"yu işaretli
+     * gösterirdi.
+     */
+    preference: HanuiColorPreference;
+    /** `'system'` verildiğinde AÇIK seçim silinir ve sistem tercihi izlenir. */
+    setScheme: (preference: HanuiColorPreference) => void;
+    /** Açık ↔ koyu. `system` iken ÇÖZÜLMÜŞ değerin tersine geçer. */
+    toggle: () => void;
+    /** Sunucu çıktısında ve hidrasyondan önceki ilk karede `false`. */
+    isReady: boolean;
+};
+
 /** Bir temanın token → değer eşlemesi. Kısmî verilebilir; eksikler varsayılandan gelir. */
 export declare type HanuiThemeTokens = Partial<Record<HanuiToken, string>>;
 
@@ -1608,38 +858,7 @@ declare type HubProps = {
 
 export declare const IconButton: typeof IconButton_2;
 
-/**
- * Yalnızca ikon taşıyan düğme.
- *
- * <p>`label` <strong>zorunlu</strong>: görsel etiketi olmayan bir düğme
- * `aria-label` olmadan ekran okuyucuda "düğme" diye okunur. Zorunlu tutmak,
- * unutulmasını derleme zamanında engeller.
- *
- * <p>Dokunma hedefi 44×44 px'ten küçük olamaz (WCAG 2.5.8) — görsel kutu daha
- * küçük olsa bile tıklanabilir alan korunur.
- *
- * <h3>`href` verilince `<a>` çizilir</h3>
- * Bir tablo satırının "düzenle" simgesi görsel olarak düğme ama davranışı
- * bağlantı: orta tuşla yeni sekmede açılması, adresinin kopyalanabilmesi ve
- * tarayıcı geçmişine girmesi beklenen davranış. `onClick` + `router.push` ile
- * yazıldığında bunların hiçbiri çalışmıyordu.
- *
- * <p>Bağlantı kipinde `disabled` YOKTUR — `<a>` etiketinin devre dışı hâli
- * yok ve `aria-disabled` tıklamayı engellemez. Erişilemez olması gereken bir
- * eylem hiç çizilmez.
- *
- * <h3>Native `title` YAZILMAZ</h3>
- * Düğme `label`ı yalnızca `aria-label`a koyar. Önce ikisi birlikte
- * yazılıyordu (`title="Şifreyi göster" aria-label="Şifreyi göster"`) ve bu üç
- * ayrı sorun üretiyordu: tarayıcının balonu <strong>dokunmatikte hiç
- * görünmez</strong> — trafiğin ağırlığı mobil olan bir arayüzde açıklamanın
- * hiç olmaması demek; klavyeyle gelen kullanıcıda gecikmeli çıkar ve biçimi
- * işletim sistemine bağlıdır; bazı ekran okuyucular `aria-label` ile birlikte
- * ikisini de okuyup adı <em>iki kez</em> söyler. Görünür bir açıklama isteyen
- * çağıran düğmeyi {@link Tooltip} ile sarar — balon dokunmatikte uzun basmayla
- * da açılır. Yine de `title` geçirmek isteyen `...rest` ile geçirebilir; karar
- * artık çağıranın.
- */
+/** Yalnızca ikon taşıyan düğme. */
 declare const IconButton_2: ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & {
 icon: ReactNode;
 /** Görsel etiketi olmayan düğmenin erişilebilir adı — ZORUNLU. */
@@ -1662,28 +881,11 @@ export declare type IconButtonVariant = 'ghost' | 'outline' | 'solid' | 'cart' |
 /**
  * Kütüphaneyi <strong>React ağacının dışından</strong> yapılandırır.
  *
- * <h3>Ne zaman bu, ne zaman `HanuiProvider`</h3>
- * `HanuiProvider` React'in içinde yaşıyor ve yönlendirici bileşenini de
- * taşıyor — normal yol o. Bu fonksiyon iki durum için:
- *
- * <ul>
- *   <li><strong>Boyamadan önce çalışması gereken tema.</strong> Sağlayıcı
- *       ağaç monte olduktan sonra yazıyor; koyu tema seçmiş bir kullanıcı o
- *       ana kadar beyaz ekran görüyor. `<head>` içindeki satır içi bir
- *       betikten çağrıldığında ezmeler ilk boyamadan önce yerinde olur.</li>
- *   <li><strong>React kullanmayan bir kabuk.</strong> Tasarım token'ları
- *       yalnızca CSS; bir e-posta önizlemesi ya da Storybook temasında
- *       bileşen ağacı olmadan da gerekiyor.</li>
- * </ul>
- *
- * <p>İkisi birlikte kullanılabilir: aynı `<style>` etiketini paylaşırlar ve
- * son çağrı kazanır.
- *
  * @example
  * // app/layout.tsx — <head> içine, boyamadan önce.
  * <script dangerouslySetInnerHTML={{ __html: `
- *   document.documentElement.dataset.hanuiTheme =
- *     localStorage.getItem('theme') ?? 'light';
+ * document.documentElement.dataset.hanuiTheme =
+ * localStorage.getItem('theme') ?? 'light';
  * ` }} />
  */
 export declare const initHanui: (options?: InitHanuiOptions) => void;
@@ -1699,25 +901,13 @@ export declare type InitHanuiOptions = Partial<{
     /**
      * Bilgi yoğunluğu. Verilmezse `<html data-hanui-density>` neyse o kalır;
      * o da yoksa `default`.
-     *
-     * <p>Uygulama başına SABİT bir karar olduğunda (operasyon paneli her zaman
-     * `compact`) buradan verilir; kullanıcıya seçtiren bir uygulama özniteliği
-     * kendisi yazar.
      */
     density: HanuiDensity;
 }>;
 
 export declare const Input: typeof Input_2;
 
-/**
- * Metin girdisi.
- *
- * <p>Ön ek / son ek girdinin <em>içinde</em> konumlanır; girdinin yanına ayrı
- * bir kutu koymak hizalamayı bozar ve odak halkasını ikiye böler.
- *
- * <p>Odak halkası sarmalayıcıda değil girdinin kendisinde: sarmalayıcıya
- * verildiğinde `:focus-visible` klavye/fare ayrımını kaybediyordu.
- */
+/** Metin girdisi. */
 declare const Input_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "prefix"> & {
 /** Solda gösterilen ikon veya ön ek (arama simgesi, para birimi). */
 prefix?: ReactNode;
@@ -1731,52 +921,29 @@ testId?: string;
 /** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */
 export declare const isKeyboardOpeningElement: (element: Element | null) => boolean;
 
-/**
- * AÇIK TEMA — varsayılan.
- *
- * <p>Bilgi yoğunluğu yüksek ekranlarda açık zeminde okunurluk daha yüksek.
- */
+/** AÇIK TEMA — varsayılan. */
 export declare const LIGHT_THEME: {
-    readonly page: "#f6f7f9";
+    readonly page: "#f4f8f7";
     readonly surface: "#ffffff";
-    readonly 'surface-2': "#eef0f4";
-    readonly 'surface-3': "#e7eaef";
-    readonly 'surface-inset': "#fafbfc";
-    readonly border: "#d6dce4";
-    readonly 'border-strong': "#c9d0da";
-    readonly text: "#11151b";
-    readonly 'text-2': "#5a6472";
-    readonly 'text-3': "#626c7a";
-    readonly graphite: "#1f2937";
-    readonly 'graphite-2': "#2b3646";
-    readonly 'graphite-3': "#3a4658";
-    readonly action: "#1f2937";
-    readonly 'action-hover': "#2b3646";
-    readonly 'action-active': "#3a4658";
+    readonly 'surface-2': "#eff4f1";
+    readonly 'surface-3': "#e8efec";
+    readonly 'surface-inset': "#f9fbfa";
+    readonly border: "#d6e1dc";
+    readonly 'border-strong': "#c5d3cc";
+    readonly text: "#00120f";
+    readonly 'text-2': "#38594f";
+    readonly 'text-3': "#506d63";
+    readonly graphite: "#00322a";
+    readonly 'graphite-2': "#004d40";
+    readonly 'graphite-3': "#0f574a";
+    readonly action: "#00322a";
+    readonly 'action-hover': "#004d40";
+    readonly 'action-active': "#0f574a";
     readonly 'on-action': "#ffffff";
     /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. Button `:disabled`). */
-    readonly 'action-soft': "#c9d0da";
-    /**
-     * PASİF DOLGU ÜZERİNDEKİ METİN.
-     *
-     * <p>ÖLÇÜLDÜ: pasif düğme `action-soft` zeminine `on-action` (beyaz) metin
-     * yazıyordu — açık temada <strong>1,55:1</strong>, koyu temada 1,93:1.
-     * Ekranda "Ara", "Sorgula", "Giriş yap" yıkanmış duruyor; etiketin ne
-     * dediği okunmuyordu.
-     *
-     * <p>WCAG pasif denetimleri hem 1.4.3'te hem 1.4.11'de açıkça muaf tutuyor,
-     * yani bu bir İHLAL DEĞİLDİ — ve tam da bu yüzden hiçbir katman uyarmadı:
-     * çift denetçinin listesinde de yoktu. Ama okunamayan bir etiket, düğmenin
-     * neyi engellediğini de söylemez; kullanıcı "neden pasif" sorusunu
-     * soramadan önce "bu neydi" sorusunda takılıyor. Pasiflik dolgunun
-     * geri çekilmesiyle bildirilir, metnin silinmesiyle değil — `opacity` ile
-     * soluklaştırma yasağının (`A11Y.md`) aynı gerekçesi.
-     *
-     * <p>Ton merdivenin kendisinden: açıkta `n700` (6,52:1), koyuda `n300`
-     * (5,76:1). Çift artık `check-contrast.mjs`te ve eşiği tutmayan bir tema
-     * derlemeyi kırar.
-     */
-    readonly 'on-action-soft': "#3a424f";
+    readonly 'action-soft': "#c5d3cc";
+    /** PASİF DOLGU ÜZERİNDEKİ METİN. */
+    readonly 'on-action-soft': "#26403a";
     readonly amber: "#f59e0b";
     readonly 'amber-hover': "#d98706";
     readonly 'amber-active': "#b87205";
@@ -1788,15 +955,15 @@ export declare const LIGHT_THEME: {
     readonly 'blue-text': "#1d54c4";
     readonly 'blue-tint': "#eaf1fe";
     readonly 'blue-line': "#bcd2fb";
-    readonly 'ok-bg': "#e8f4eb";
-    readonly 'ok-fg': "#1d6e31";
-    readonly 'ok-line': "#a8dcb7";
+    readonly 'ok-bg': "#e6f4ed";
+    readonly 'ok-fg': "#156f4e";
+    readonly 'ok-line': "#a8dcc4";
     readonly 'warn-bg': "#fdf0dd";
     readonly 'warn-fg': "#7a3e02";
     readonly 'warn-line': "#ebc687";
-    readonly 'off-bg': "#f1f2f5";
-    readonly 'off-fg': "#3a424f";
-    readonly 'off-line': "#ccd2db";
+    readonly 'off-bg': "#f0f4f3";
+    readonly 'off-fg': "#26403a";
+    readonly 'off-line': "#cddad4";
     readonly 'bad-bg': "#f8ebeb";
     readonly 'bad-fg': "#bb1e1e";
     readonly 'bad-line': "#e6a6a6";
@@ -1806,25 +973,25 @@ export declare const LIGHT_THEME: {
     readonly 'alt-bg': "#eeebfa";
     readonly 'alt-fg': "#2e2661";
     readonly 'alt-line': "#c0b6ea";
-    readonly 'sale-bg': "#e8f4eb";
-    readonly 'sale-fg': "#1d6e31";
+    readonly 'sale-bg': "#e6f4ed";
+    readonly 'sale-fg': "#156f4e";
     readonly 'red-accent': "#dc2626";
-    readonly 'green-accent': "#299d46";
-    readonly 'green-accent-hover': "#23883c";
-    readonly 'on-green': "#06280f";
+    readonly 'green-accent': "#1d9a64";
+    readonly 'green-accent-hover': "#17814f";
+    readonly 'on-green': "#02180f";
     readonly star: "#9a5f04";
     readonly 'danger-solid': "#dc2626";
     readonly 'danger-solid-hover': "#bb1e1e";
     readonly 'on-danger': "#ffffff";
     readonly 'nav-bg': "#ffffff";
-    readonly 'nav-bg-2': "#eef0f4";
-    readonly 'nav-fg': "#11151b";
-    readonly 'nav-fg-2': "#5a6472";
-    readonly 'nav-fg-3': "#626c7a";
-    readonly 'nav-line': "#e2e6ec";
-    readonly 'nav-line-strong': "#c9d0da";
-    readonly 'nav-hover': "#eef0f4";
-    readonly 'footer-bg': "#eef0f4";
+    readonly 'nav-bg-2': "#eff4f1";
+    readonly 'nav-fg': "#00120f";
+    readonly 'nav-fg-2': "#38594f";
+    readonly 'nav-fg-3': "#506d63";
+    readonly 'nav-line': "#e3eae7";
+    readonly 'nav-line-strong': "#c5d3cc";
+    readonly 'nav-hover': "#eff4f1";
+    readonly 'footer-bg': "#eff4f1";
     readonly 'shadow-xs': `0 1px 2px ${string}`;
     readonly 'shadow-sm': `0 1px 2px ${string}, 0 1px 3px ${string}`;
     readonly 'shadow-md': `0 2px 4px ${string}, 0 6px 16px ${string}`;
@@ -1842,25 +1009,18 @@ export declare const LIGHT_THEME: {
     readonly glass: string;
     readonly 'glass-solid': "#ffffff";
     readonly 'on-scrim': "#ffffff";
-    readonly 'skeleton-a': "#eef0f4";
-    readonly 'skeleton-b': "#fafbfc";
+    readonly 'skeleton-a': "#eff4f1";
+    readonly 'skeleton-b': "#f9fbfa";
     readonly track: string;
     /** Görsel yer tutucu (medya yoksa). */
-    readonly 'media-bg': "#eef0f4";
+    readonly 'media-bg': "#eff4f1";
     readonly 'glow-1': string;
     readonly 'glow-2': string;
     readonly 'glow-amber': string;
 };
 
 declare type LinkProps = BaseProps_4 & {
-    /**
-     * Sayfa numarasının adresini üretir.
-     *
-     * <p>Verildiğinde numaralar `<a>` olur — ve olması gerekir. Düğmenin `href`i
-     * yok: arama motoru bir tıklama olayını çalıştırmaz ve ikinci sayfaya HİÇ
-     * geçemez; kullanıcı da orta tuşla yeni sekmede açamaz, adresi kopyalayamaz,
-     * durum çubuğunda hedefi göremez.
-     */
+    /** Sayfa numarasının adresini üretir. */
     buildHref: (page: number) => string;
     onPageChange?: never;
     /** Yönlendiriciye geçirilecek ek props (`{ scroll: false }` gibi). */
@@ -1870,13 +1030,7 @@ declare type LinkProps = BaseProps_4 & {
 export declare type ListboxNavigation<T extends HTMLElement = HTMLElement> = {
     activeIndex: number;
     setActiveIndex: (index: number) => void;
-    /**
-     * Etkin seçeneği görünür alanda tutmak için LİSTEYE bağlanır.
-     *
-     * <p>Tip parametresi çağıran taraf için: `Select` bu referansı `<ul>`e
-     * veriyor ve panel açıldığında `focus()` çağırıyor. `HTMLElement`e sabitlense
-     * çağıran ikinci bir referans tutmak ve ikisini elle eşlemek zorunda kalırdı.
-     */
+    /** Etkin seçeneği görünür alanda tutmak için LİSTEYE bağlanır. */
     listRef: RefObject<T | null>;
     handleKeyDown: (event: KeyboardEvent_2<HTMLElement>) => void;
 };
@@ -1892,52 +1046,12 @@ export declare type ListboxNavigationOptions = {
     onClose: () => void;
 };
 
-/**
- * Aranan metin, hedefin içinde geçiyor mu?
- *
- * <p>Aramanın tek kapısı burasıdır: her liste kendi `includes` çağrısını
- * yazdığında biri normalizasyonu atlıyor ve o listede aksanlı arama
- * çalışmıyordu.
- */
+/** Aranan metin, hedefin içinde geçiyor mu? */
 export declare const matchesSearch: (haystack: string, needle: string) => boolean;
 
 export declare const Menu: typeof Menu_2;
 
-/**
- * Menü — bir listeden EYLEM seçme.
- *
- * <h3>{@link Select} ile farkı: seçim mi eylem mi</h3>
- * Görsel olarak benzerler; ayrım seçilen şeyin ne olduğunda:
- *
- * <ul>
- *   <li>`Select` bir DEĞER seçer. Seçim kalıcıdır, tetikleyicide görünür ve
- *       geri alınabilir. ARIA rolü `listbox`.</li>
- *   <li><b>`Menu` bir EYLEM çalıştırır.</b> "Sil", "Kopyala", "Dışa aktar".
- *       Seçilen şey hatırlanmaz; menü kapanır ve iş yapılır. ARIA rolü
- *       `menu`.</li>
- * </ul>
- *
- * <p>Ayrım ekran okuyucuda duyuluyor: `listbox` "3 seçenekten 2.'si seçili"
- * der, `menu` "menü, 3 öğe" der. Eylem listesini `listbox` olarak sunmak,
- * kullanıcıya kalıcı bir seçim yaptığını söylüyordu.
- *
- * <h3>Odak GERÇEKTEN taşınır</h3>
- * `Select` odağı tetikleyicide tutup etkin seçeneği `aria-activedescendant`
- * ile bildiriyor; menüde bu YANLIŞ olurdu. APG menü deseni gerçek odak
- * istiyor çünkü menü öğeleri düğme gibi davranıyor — ve harfe atlama
- * (type-ahead) yalnızca odaklanmış bir öğe üzerinde anlamlı.
- *
- * <h3>Klavye (APG: menu button)</h3>
- * <table>
- *   <tr><td>`Enter` / `Space` / `ArrowDown`</td><td>tetikleyicide: açar, İLK öğeye odaklanır</td></tr>
- *   <tr><td>`ArrowUp`</td><td>tetikleyicide: açar, SON öğeye odaklanır</td></tr>
- *   <tr><td>`ArrowDown` / `ArrowUp`</td><td>öğeler arasında; uçlarda DÖNER</td></tr>
- *   <tr><td>`Home` / `End`</td><td>ilk / son öğe</td></tr>
- *   <tr><td>harf</td><td>o harfle başlayan ilk öğeye atlar</td></tr>
- *   <tr><td>`Enter` / `Space`</td><td>öğeyi çalıştırır ve menüyü kapatır</td></tr>
- *   <tr><td>`Escape` / `Tab`</td><td>kapatır, odak TETİKLEYİCİYE döner</td></tr>
- * </table>
- */
+/** Menü — bir listeden EYLEM seçme. */
 declare const Menu_2: ({ trigger, items, label, side, align, className, testId, }: Props_4) => JSX.Element | null;
 
 export declare type MenuItem = {
@@ -1950,37 +1064,7 @@ export declare type MenuItem = {
     isDanger?: boolean;
 };
 
-/**
- * ÖLÇÜ TOKEN'LARI — temadan bağımsız, çalışma zamanında EZİLEBİLİR.
- *
- * <h3>Neden bunlar da CSS değişkeni</h3>
- * Bir zamanlar yalnızca renkler ve font aileleri çalışma zamanında
- * eziliyordu; yarıçap, boşluk, süre ve tipografi ölçeği `_variables.scss`
- * içinde SCSS sabitiydi. Sonucu şuydu: bir tüketici markasının RENGİNİ
- * verebiliyor ama YUVARLAKLIĞINI veremiyordu. Oysa bir markayı tanınır kılan
- * şeylerin listesinde yarıçap renkten sonra gelir — keskin köşeli bir
- * kurumsal panelle yumuşak köşeli bir vitrin aynı pakete aynı derecede
- * ihtiyaç duyuyor. Aynısı bilgi yoğunluğu (boşluk ölçeği) ve hareket süresi
- * için de geçerli.
- *
- * <h3>SCSS sabiti olarak KALANLAR ve nedenleri</h3>
- * <ul>
- *   <li><b>Kırılma noktaları</b> — `@media (max-width: var(--x))` GEÇERSİZ
- *       CSS. Medya sorgusu özel özellik okuyamaz; taşınsalardı bütün duyarlı
- *       yerleşim sessizce çökerdi.</li>
- *   <li><b>Katman (`z-*`)</b> — bir yığılma bağlamı sayısı, marka kararı
- *       değil. Tüketicinin ezmesi gereken bir şey değil; ezerse kip pencere
- *       perdenin altında kalır.</li>
- *   <li><b>Ağırlık, harf aralığı, kapsayıcı genişlikleri, sayfa dolgusu</b> —
- *       ölçek değil tekil değer; ezme ihtiyacı ölçülmedi. Gerektiğinde
- *       buraya taşınabilir, ters yön (geri alma) kırıcıdır.</li>
- * </ul>
- *
- * <h3>Değerler DİZE, sayı değil</h3>
- * `'4px'` yazılıyor çünkü çıktı doğrudan bir CSS bildirimi. Sayı tutulup
- * birim sonradan eklenseydi, `radius-pill` (999px) ile `leading-normal`
- * (birimsiz 1.62) aynı listede duramazdı.
- */
+/** ÖLÇÜ TOKEN'LARI — temadan bağımsız, çalışma zamanında EZİLEBİLİR. */
 export declare const METRIC_TOKENS: {
     readonly 'radius-xs': "4px";
     readonly 'radius-sm': "6px";
@@ -2032,54 +1116,12 @@ export declare const METRIC_TOKENS: {
 /**
  * Kırılma noktaları — `styles/_variables.scss` içindeki `$breakpoint-*` ile
  * <strong>aynı</strong> değerler.
- *
- * <p>Kararı normalde CSS verir; bu sabitler yalnızca <em>JavaScript'in de
- * bilmek zorunda olduğu</em> tek durum için var: kipsel bir panel
- * (`<dialog>`) açıkken pencere büyütüldüğünde. `showModal()` sayfanın geri
- * kalanını inert bırakır ve bu, panelin çizilip çizilmediğine değil kipsel
- * olmasına bağlıdır — CSS onu gizlese bile sayfa tıklanamaz kalır. Panel bu
- * yüzden kırılma noktası aşıldığında JavaScript ile kapatılır.
- *
- * <p>Değerler iki yerde durduğu için ayrışabilir. Ayrışırlarsa panel yanlış
- * genişlikte kapanır; CSS tarafı her zaman kazanır, buradaki değer ona
- * uydurulur.
  */
 export declare const MOBILE_BREAKPOINT = 640;
 
 export declare const Modal: typeof Modal_2;
 
-/**
- * Kip pencere (modal).
- *
- * <h3>Yerel `<dialog>` + `showModal()`</h3>
- * Odak tuzağı, Escape ile kapanma, arka planın etkileşime kapanması ve
- * `aria-modal` semantiği tarayıcıdan gelir. Bunları `<div>` üzerine elle
- * kurmak yüzlerce satır ve kaçınılmaz olarak eksik bir odak yönetimi demek.
- *
- * <h3>Neden `open` özniteliği değil `showModal()`</h3>
- * `<dialog open>` pencereyi <em>kipsiz</em> açar: arka plan tıklanabilir kalır
- * ve odak tuzağı çalışmaz. Kipli davranışın tek yolu yöntemi çağırmak.
- *
- * <h3>Arka planın kaydırılması ayrıca engellenir</h3>
- * `showModal()` arka planı <em>etkileşime</em> kapatır ama tarayıcıların bir
- * kısmında sayfa hâlâ kaydırılabiliyor: kullanıcı pencereyi kaydırdığını
- * sanırken arkadaki listeyi kaydırıyordu. `<body>` kilitlenir.
- *
- * <h3>Mobilde alt sayfaya düşer</h3>
- * Dar ekranda ortalanmış bir pencere, klavye açıldığında yukarı sıkışıyor ve
- * dip düğmeleri klavyenin altında kalıyordu. Alt sayfa baş parmağın
- * erişebildiği yerde durur.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Escape`</td><td>kapatır — `isDismissable={false}` iken KAPATMAZ</td></tr>
- *   <tr><td>`Tab`</td><td>odak panelin içinde döner (tarayıcı: `showModal()`)</td></tr>
- * </table>
- * Odak tuzağı tarayıcıdan gelir; kütüphanenin işi `cancel` olayını React
- * durumuna bağlamak. Yakalanmadığında pencere kapanıyor ama `isOpen` `true`
- * kalıyor ve bir daha açılamıyordu. Nöbetçi:
- * `components/__tests__/keyboard.test.tsx`.
- */
+/** Kip pencere (modal). */
 declare const Modal_2: ({ isOpen, onClose, title, closeLabel, children, description, footer, icon, tone, size, isDismissable, className, testId, }: Props_41) => JSX.Element;
 
 export declare type ModalTone = 'neutral' | 'danger' | 'warning' | 'success' | 'info';
@@ -2090,66 +1132,17 @@ declare type MultipleProps<T extends string> = BaseProps<T> & {
     onChange: (value: T[]) => void;
 };
 
-/**
- * Serbest metin arama anahtarı: ASCII, küçük harf, tek boşlukla ayrılmış.
- *
- * <h3>Neden aksan sökülüyor</h3>
- * Kullanıcı "sisli" yazdığında "Şişli" bulunmalı. Doğru aksanı yakalamak
- * zorunda kalmak — özellikle mobil klavyede — aramayı bitiren bir sürtünme.
- *
- * <h3>Türkçe `İ` özel durumu</h3>
- * `toLowerCase()`ten <em>önce</em> `İ → i` eşlenir: varsayılan küçültme
- * "İSTANBUL"u "i̇stanbul" (birleşik nokta ile) yapıyor ve eşleşmeyi
- * kaçırıyordu. Aynı sorun `ı` için ters yönde yok — o zaten tek kod noktası.
- *
- * <p>Latin-1 aksanları (`é`, `ñ`, `ü`…) `NFD` ayrıştırması + birleştirici
- * işaret temizliğiyle sökülür; Türkçe harfler bu yolla çözülmediği için
- * (`ı` ve `İ` ayrı kod noktaları) önce elle eşlenir.
- */
+/** Serbest metin arama anahtarı: ASCII, küçük harf, tek boşlukla ayrılmış. */
 export declare const normalizeSearchTerm: (value: string) => string;
 
 export declare const PageHeader: typeof PageHeader_2;
 
-/**
- * Sayfa başlığı — her ekranın aynı giriş bloğu.
- *
- * <h3>Neden ortak bir bileşen</h3>
- * Önceden her container kendi başlığını kuruyordu: bir sayfada punto 29 px,
- * diğerinde 23 px; birinde açıklama başlığın altında, birinde yanında;
- * boşluklar 8 px ile 24 px arasında dolaşıyordu. Sayfalar arası geçiş "başka
- * bir siteye geçtim" hissi veriyordu. Bu bileşen o kararları tek yerde verir.
- *
- * <h3>Açıklama genişliği sınırlı</h3>
- * Başlık tam genişlikte akabilir ama açıklama 68ch'de durur: 1360 px
- * genişlikte akan bir açıklama satırında göz satır sonunda yerini kaybediyor.
- *
- * <h3>Eylemler `flex-end`</h3>
- * Düğmeler başlık bloğunun ALT kenarına hizalanır. `baseline` verildiğinde iki
- * satırlık başlıklarda düğme ilk satıra çekiliyordu.
- */
+/** Sayfa başlığı — her ekranın aynı giriş bloğu. */
 declare const PageHeader_2: FC<Props_25>;
 
 export declare const Pagination: typeof Pagination_2;
 
-/**
- * Sayfalama.
- *
- * <h3>Sayfa numaraları BAĞLANTI, düğme değil</h3>
- * `buildHref` verildiğinde numaralar `<a>` olur. Düğme olarak bırakıldığında
- * iki bedeli vardı:
- * <ul>
- *   <li><strong>Tarayıcı (crawler) ikinci sayfaya geçemiyordu.</strong> Düğmenin
- *       `href`i yok; arama motoru bir tıklama olayını çalıştırmaz. Derin
- *       sayfalardaki kayıtlar yalnızca sitemap'te göründükleri kadar
- *       keşfedilebiliyordu.</li>
- *   <li><strong>Kullanıcı yeni sekmede açamıyordu.</strong> Orta tık, Cmd+tık ve
- *       "bağlantıyı kopyala" çalışmıyor, durum çubuğunda hedef görünmüyordu.</li>
- * </ul>
- *
- * <p>Oklar her iki kipte de `IconButton`: devre dışı kalabildikleri için düğme
- * kalırlar — `<a>` etiketinin "devre dışı" hâli yok, `aria-disabled` ise
- * tıklamayı engellemez. Sayfa numaraları tarayıcıya zaten tam listeyi veriyor.
- */
+/** Sayfalama. */
 declare const Pagination_2: FC<Props_49>;
 
 export declare const Panel: typeof Panel_2;
@@ -2157,43 +1150,14 @@ export declare const Panel: typeof Panel_2;
 /**
  * Panel — başlığı olan içerik kutusu.
  *
- * <h3>Neden bu bileşen var</h3>
- * Bir uygulamanın on bir ayarlar sayfası, on bir farklı kart kuruyordu:
- * birinde dolgu 16 px diğerinde 24 px, birinde başlık kartın içinde diğerinde
- * dışında, birinde `max-width: 560px` diğerinde tam genişlik. Aynı disiplinde
- * görünmeleri için kararların tek yerde verilmesi gerekiyordu.
- *
- * <h3>Genişlik paneli DEĞİL içeriği sınırlar</h3>
- * Panel her zaman kapsayıcısını doldurur. Form alanlarının okunabilir satır
- * uzunluğunu aşmaması gerekiyorsa {@link PanelForm} kullanılır — o iç ızgarayı
- * sınırlar, panelin kendisini daraltmaz. Önceden bir "profil düzenle" paneli
- * sayfanın üçte biri kadar kalıp yanındaki boşluğa bakıyordu; sorun formun
- * değil PANELİN daraltılmasıydı.
- *
- * <h3>Dip şeridi o sütunu izler</h3>
- * Panelde bir `PanelForm` varsa `footer` içeriği <strong>aynı sütunda</strong>
- * biter. Şeridin kendisi (zemin + üst çizgi) tam genişlikte kalır; hizalanan
- * yalnızca içeriği. Ölçüldü: form 565 px'lik sütununu bitirirken kaydet
- * düğmesi panelin öbür ucunda, formdan 576 px uzakta duruyordu — göz formu
- * bitiriyor, düğmeyi arıyordu. `PanelForm` kullanılmayan panelde kural
- * uygulanmaz: orada sınırlanacak bir sütun yok ve şeridin sağa yaslanması
- * doğru davranış.
- *
  * @example
  * <Panel title="Profil bilgileri" description="Fatura bu bilgilerle kesilir">
- *   <PanelForm>…alanlar…</PanelForm>
+ * <PanelForm>…alanlar…</PanelForm>
  * </Panel>
  */
 declare const Panel_2: FC<Props_26>;
 
-/**
- * Panel içindeki form ızgarası.
- *
- * <p>Genişliği SINIRLI (`$measure-narrow`): girdi alanları okunabilir satır
- * uzunluğunun ötesine uzamamalı — 900 px genişliğinde bir metin kutusu
- * doldurulması zor görünür. Ama bu sınır PANELE değil ızgaraya uygulanır;
- * panel tam genişlikte kalır ve sayfa düzeni bozulmaz.
- */
+/** Panel içindeki form ızgarası. */
 export declare const PanelForm: FC<PanelFormProps>;
 
 declare type PanelFormProps = {
@@ -2203,12 +1167,7 @@ declare type PanelFormProps = {
     className?: string;
 };
 
-/**
- * İki alanı yan yana koyan satır. Dar ekranda alt alta düşer.
- *
- * <p>`PanelForm columns={2}` tüm ızgarayı ikiye böler; bu yalnızca TEK bir
- * satırı böler (ad + soyad gibi).
- */
+/** İki alanı yan yana koyan satır. Dar ekranda alt alta düşer. */
 export declare const PanelRow: FC<PanelRowProps>;
 
 declare type PanelRowProps = {
@@ -2216,40 +1175,20 @@ declare type PanelRowProps = {
     className?: string;
 };
 
-export declare const Popover: typeof Popover_2;
+export declare const PasswordInput: typeof PasswordInput_2;
 
 /**
- * Popover — <strong>eylem taşıyabilen</strong>, odaklanabilir yüzey.
- *
- * <h3>{@link Tooltip} ile farkı: içine ne konabildiği</h3>
- * İkisi de tetikleyiciye yapışan bir yüzey açıyor; ayrım içeriğin
- * ERİŞİLEBİLİR olup olmamasında:
- *
- * <ul>
- *   <li>`Tooltip` yalnızca AÇIKLAMA taşır. `pointer-events: none` ve klavyeyle
- *       içine girilemez — içine bir bağlantı konsa ona ulaşmanın yolu olmazdı
- *       (fare balona giderken tetikleyiciden çıkıyor).</li>
- *   <li><b>`Popover` odak alır.</b> Açıldığında odak içeri girer, `Escape`
- *       kapatır ve odak tetikleyiciye döner. Bağlantı, düğme, kısa bir form
- *       konabilir.</li>
- * </ul>
+ * Şifre girdisi — yanında göz düğmesi.
  *
- * <h3>Kipsel DEĞİL</h3>
- * Arka plan tıklanabilir kalır ve sayfa kaydırılabilir. Kararı bekleyen,
- * kaçınılmaz bir seçim `Modal`ın işi; popover yardımcı bir yüzey ve
- * kullanıcıyı hapsetmemeli. Bu yüzden `<dialog>` DEĞİL portal + `usePositioning`:
- * `showModal()` arka planı inert bırakıyor, `<dialog open>` (kipsiz) ise üst
- * katmana hiç girmiyor ve `z-index` yarışına dönüyordu.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Enter` / `Space`</td><td>tetikleyicide: açar</td></tr>
- *   <tr><td>`Escape`</td><td>kapatır, odak TETİKLEYİCİYE döner</td></tr>
- *   <tr><td>`Tab`</td><td>yüzeyin içinde gezinir; dışına çıkınca KAPANIR</td></tr>
- * </table>
- * Odak tuzağı YOK — kipsel olmayan bir yüzeyde odağı hapsetmek, kullanıcıyı
- * sayfadan koparır. Odak dışarı çıktığında yüzey kapanır.
+ * `hanparca-admin` ve `hanparca-frontend`te BİREBİR AYNI dosya olarak
+ * duruyordu; iki kopya da hanui'nin `Input` + `IconButton` bileşenlerini
+ * sarmalıyordu, yani zaten bu kütüphaneye aitti.
  */
+declare const PasswordInput_2: FC<Props_13>;
+
+export declare const Popover: typeof Popover_2;
+
+/** Popover — <strong>eylem taşıyabilen</strong>, odaklanabilir yüzey. */
 declare const Popover_2: ({ trigger, children, label, side, align, isOpen: controlledOpen, onOpenChange, className, testId, }: Props_5) => JSX.Element | null;
 
 /** Tercih edilen kenar boyunca hizalama. */
@@ -2290,73 +1229,19 @@ export declare const preventAutoKeyboard: (dialog: HTMLDialogElement) => void;
 
 export declare const Price: typeof Price_2;
 
-/**
- * Tutar gösterimi.
- *
- * <h3>Bileşen HESAP YAPMAZ</h3>
- * Tutar biçimlenmiş gelir. Kuruşu istemcide çevirmek kayan nokta hatası riski
- * taşır ve biçimlendirme iki yerde ayrışır: aynı ürün listede "1.299,90",
- * detayda "1299.9" çıkıyordu. İndirim oranı da dışarıdan gelir — burada
- * `(1 - fiyat/liste)` hesaplamak için biçimlenmiş metni sayıya çevirmek
- * gerekirdi ve o kırılgan bir iş.
- *
- * <h3>Tutar NÖTR kalır</h3>
- * Güncel tutar `$text`; üstü çizili eski tutar `$text-3`; indirim yüzdesi
- * küçük bir yeşil rozet. Kırmızı fiyat ucuz durur ve kırmızıyı "olumsuz"
- * anlamından koparır.
- */
+/** Tutar gösterimi. */
 declare const Price_2: FC<Props_27>;
 
 export declare const Progress: typeof Progress_2;
 
-/**
- * İlerleme çubuğu — <strong>ölçülebilir</strong> bekleme.
- *
- * <h3>{@link Spinner} ile farkı: sonu bilinip bilinmediği</h3>
- * `Spinner` "bir şey oluyor" der ve başka bir şey söyleyemez. Ölçülebilir bir
- * işte (dosya yükleme, içe aktarma, çok adımlı ödeme) bu yetmiyor: kullanıcı
- * beklemeye değip değmeyeceğine karar veremiyor ve iki saniyeyle iki dakika
- * arasındaki farkı ancak bekleyerek öğreniyordu.
- *
- * <p>`value` verilmediğinde çubuk BELİRSİZ kipe düşer: yine bir çubuk çizer
- * ama `aria-valuenow` yazmaz. Bu kasıtlı — bilinmeyen bir değeri "0" diye
- * bildirmek, ekran okuyucuya işin hiç ilerlemediğini söylüyordu.
- *
- * <h3>Yüzde tek başına yeterli DEĞİL</h3>
- * `valueText` verildiğinde ekran okuyucu onu okur ("5 dosyadan 3'ü"), yüzdeyi
- * değil. Aynı bilgi görsel tarafta `isValueVisible` ile yazılabiliyor; ikisi
- * de aynı gerçeği söylemek zorunda.
- *
- * <h3>Renk tek başına anlam taşımaz</h3>
- * `tone` yalnızca bir vurgu: "tamamlandı" ya da "başarısız" durumu çubuğun
- * rengiyle DEĞİL, yanındaki metinle ve çağıran tarafın çizdiği ikonla
- * anlatılır (WCAG 1.4.1).
- */
+/** İlerleme çubuğu — <strong>ölçülebilir</strong> bekleme. */
 declare const Progress_2: ({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: Props_33) => JSX.Element;
 
 export declare const ProgressCircle: MemoExoticComponent<({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: CircleProps) => JSX.Element>;
 
 export declare const PromptDialog: typeof PromptDialog_2;
 
-/**
- * Metin isteyen pencere — `window.prompt()` yerine.
- *
- * <h3>Neden</h3>
- * Tarayıcı istemi tek satırlık, biçimlenemiyor, ana iş parçacığını
- * kilitliyor ve bazı tarayıcılarda sayfayı engelliyor. Bu bileşen aynı işi
- * `Modal` + `Field` + girdi ile yapar ve pencere kapanma kuralını
- * (aşağıda) getirir.
- *
- * <h3>Pencere yalnızca BAŞARIDA kapanır</h3>
- * `onSubmit` reddederse pencere açık kalır ve yazılan metin korunur — istek
- * patlarsa kullanıcının yazdığı gerekçe geri dönüşsüz silinmemeli. Değer
- * yalnızca pencere <em>yeniden açılırken</em> `defaultValue`dan tazelenir.
- *
- * <h3>Enter gönderir</h3>
- * Girdi bir `<form>` içinde; dip düğmesi `form` özniteliğiyle ona bağlanır
- * (`Modal` dip şeridi formun dışında çizer). `multiline` kipinde Enter satır
- * başı yapar, gönderme düğmeden.
- */
+/** Metin isteyen pencere — `window.prompt()` yerine. */
 declare const PromptDialog_2: FC<Props_45>;
 
 declare type Props = {
@@ -2364,11 +1249,6 @@ declare type Props = {
     /**
      * Tema ezmeleri. Yalnızca DEĞİŞTİRİLEN token'lar verilir; verilmeyen her
      * token varsayılanında kalır.
-     *
-     * <p>Nesne referansı her render'da yeniden üretilirse (satır içi nesne
-     * literali) `<style>` etiketi de her render'da yeniden yazılır. Bileşen
-     * bunu içerik karşılaştırmasıyla engeller ama yine de sabit bir referans
-     * (modül düzeyinde tanımlı bir nesne) tercih edilmeli.
      */
     theme?: HanuiThemeConfig;
     /**
@@ -2379,33 +1259,11 @@ declare type Props = {
      * <HanuiProvider linkComponent={NextLink}>…</HanuiProvider>
      */
     linkComponent?: HanuiLinkComponent;
-    /**
-     * Arayüz metinleri — bir kez, burada.
-     *
-     * <p>Kütüphane hiçbir dilde metin uydurmaz ama aynı "Kapat" dizesini yüz
-     * çağrı yerine dağıtmak da doğru değildi: biri değiştiğinde doksan dokuzu
-     * eski kalıyordu. Çözümleme sırası prop → buradaki config; ikisi de yoksa
-     * geliştirme kipinde konsola uyarı düşer.
-     *
-     * <p>Öğeye ÖZGÜ metinler buraya girmez (`Modal.title`,
-     * `ConfirmDialog.confirmLabel`, `IconButton.label`); onlar prop olarak
-     * zorunlu kalır çünkü her çağrı yerinde farklıdır.
-     */
+    /** Arayüz metinleri — bir kez, burada. */
     labels?: HanuiLabels;
 };
 
 declare type Props_10 = {
-    /** Radyo grubu adı — aynı gruptaki kartlar ok tuşlarıyla gezilir. */
-    name: string;
-    value: string;
-    isSelected: boolean;
-    isDisabled?: boolean;
-    onChange: (value: string) => void;
-    /** Zengin gövde: kartın içeriği çağırana aittir. */
-    children: ReactNode;
-} & CommonElementProps;
-
-declare type Props_11 = {
     min: number;
     max: number;
     step?: number;
@@ -2430,7 +1288,7 @@ declare type Props_11 = {
     testId?: string;
 };
 
-declare type Props_12 = {
+declare type Props_11 = {
     value: number | null;
     onChange: (value: number) => void;
     /** Grubun erişilebilir adı ("Ürün puanı"). */
@@ -2438,10 +1296,6 @@ declare type Props_12 = {
     /**
      * Puan açıklamaları. Hem ekran okuyucuya okunur hem de seçildiğinde
      * yıldızların altında yazar. Verilmezse `labels.rating.scale`.
-     *
-     * <p>Dolu yıldız sayısı tek başına bir renk/şekil sinyali. Yanına açıklama
-     * yazmak hem anlamı netleştirir hem de renk körü kullanıcıya ikinci bir ipucu
-     * verir (WCAG 1.4.1).
      */
     ratingLabels?: RatingLabels;
     /**
@@ -2454,7 +1308,7 @@ declare type Props_12 = {
     testId?: string;
 };
 
-declare type Props_13 = {
+declare type Props_12 = {
     value: number;
     onChange: (value: number) => void;
     /** Grubun ve girdinin erişilebilir adı. Verilmezse `labels.quantity.label`. */
@@ -2471,6 +1325,13 @@ declare type Props_13 = {
     testId?: string;
 };
 
+declare type Props_13 = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+    /** Şifre gizliyken düğmenin erişilebilir adı. */
+    showLabel?: string;
+    /** Şifre görünürken düğmenin erişilebilir adı. */
+    hideLabel?: string;
+};
+
 declare type Props_14 = {
     values: string[];
     onChange: (values: string[]) => void;
@@ -2493,13 +1354,7 @@ declare type Props_14 = {
 
 declare type Props_15 = BaseProps_2 & {
     isRequired?: boolean;
-    /**
-     * Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)").
-     *
-     * <p>Yıldız yalnızca GÖRSEL bir kısayol; renk ve şekil tek başına anlam
-     * taşıyamaz (WCAG 1.4.1), o yüzden yanında okunabilir bir metin olmak
-     * zorunda. Verilmezse `labels.required` okunur.
-     */
+    /** Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)"). */
     requiredLabel?: string;
 };
 
@@ -2549,13 +1404,7 @@ declare type Props_18 = {
      * koşul yazması gerekmez.
      */
     imageUrl?: string;
-    /**
-     * Baş harfleri büyütürken kullanılacak dil etiketi ("tr", "az").
-     *
-     * <p>Türkçede ZORUNLU: `toUpperCase()` "i" harfini "I" yapıyor ve "İlhan"ın
-     * baş harfi "I" çıkıyor. `toLocaleUpperCase('tr')` doğru "İ" verir.
-     * Verilmezse `labels.locale`, o da yoksa çalışma ortamının varsayılan dili.
-     */
+    /** Baş harfleri büyütürken kullanılacak dil etiketi ("tr", "az"). */
     locale?: string;
     size?: 'sm' | 'md' | 'lg';
     className?: string;
@@ -2600,13 +1449,7 @@ declare type Props_21 = {
     /** Önceki/sonraki düğmelerinin erişilebilir adları. ZORUNLU. */
     previousLabel: string;
     nextLabel: string;
-    /**
-     * Sayfa göstergesinin ad üreticisi (`index` 1 tabanlı).
-     *
-     * <p>Verilmediğinde nokta göstergesi ÇİZİLMEZ: adsız bir nokta ekran
-     * okuyucuda "düğme" diye okunuyor ve kullanıcı nereye gittiğini
-     * bilmiyordu.
-     */
+    /** Sayfa göstergesinin ad üreticisi (`index` 1 tabanlı). */
     formatDotLabel?: (index: number, total: number) => string;
     /** Bir kartın asgari genişliği. Şerit buna göre kaç kart göstereceğine karar verir. */
     itemMinWidth?: number;
@@ -2617,27 +1460,14 @@ declare type Props_21 = {
 declare type Props_22 = {
     /** Gösterilecek ve panoya kopyalanacak değer. */
     value: string;
-    /**
-     * Kopyalama düğmesinin erişilebilir adı.
-     *
-     * <p>Verilmezse `labels.copyField.copy(value)` çağrılır. Config bir DİZE
-     * değil biçimlendirici tutar: ad değeri İÇERMELİ — bir listede on beş
-     * kopyalama düğmesi var ve hepsi "Kopyala" diye okunduğunda ekran okuyucu
-     * kullanıcısı hangisinin hangi kayıt olduğunu bilmiyordu.
-     */
+    /** Kopyalama düğmesinin erişilebilir adı. */
     copyLabel?: string;
     /** Kopyalandıktan sonraki ad. Verilmezse `labels.copyField.copied(value)`. */
     copiedLabel?: string;
     /** `aria-live` ile duyurulan onay cümlesi. Verilmezse `labels.copyField.announcement`. */
     copiedAnnouncement?: string;
     size?: 'sm' | 'md';
-    /**
-     * Kopyalama düğmesini gizler.
-     *
-     * <p>Yalnızca değerin <em>zaten tıklanabilir bir şeyin içinde</em> olduğu
-     * yerlerde (bir bağlantının gövdesi) verilir: iç içe etkileşim öğesi geçersiz
-     * HTML üretir.
-     */
+    /** Kopyalama düğmesini gizler. */
     isReadOnly?: boolean;
     className?: string;
     testId?: string;
@@ -2657,20 +1487,7 @@ declare type Props_24 = {
     action?: ReactNode;
     /** İkincil eylem veya ipucu. */
     secondaryAction?: ReactNode;
-    /**
-     * `error` — liste BOŞ değil, ÇEKİLEMEDİ.
-     *
-     * <p>İkisi ayrı durumlar ve ayrı görünmek zorundalar: ağ hatasını "kayıt
-     * kalmamış" diye okuyan kullanıcı yanlış karar veriyor (ürün aramayı
-     * bırakıyor, siparişinin silindiğini sanıyor). Varyant `role="alert"`
-     * taşıyor ve tonu farklı — layout aynı kalıyor ki iki durum arasındaki
-     * geçiş sıçramasın.
-     *
-     * <p>Ayrım ÖNCE bu bileşenin dışındaydı ("ağ hatasında bu bileşen
-     * çizilmez") ve sonucu şuydu: her çağıran kendi hata kutusunu yazıyor,
-     * kutular birbirinden farklı görünüyordu. Ayrım korunuyor — ama artık
-     * BİLEŞENDE kodlu, çağıranın disiplinine bırakılmış değil.
-     */
+    /** `error` — liste BOŞ değil, ÇEKİLEMEDİ. */
     tone?: 'empty' | 'error';
     size?: 'sm' | 'md';
     className?: string;
@@ -2727,19 +1544,7 @@ declare type Props_27 = {
     value: string;
     /** Para birimi simgesi ya da kodu. Verilmezse `labels.currency`. */
     currency?: string;
-    /**
-     * Değeri `Intl.NumberFormat` ile biçimlendirir.
-     *
-     * <p>`value` bu kipte de bir DİZE olarak kalıyor ve sayıya çevriliyor —
-     * bileşen hâlâ HESAP YAPMIYOR, yalnızca ayırıcıları ve para birimi
-     * konumunu yerel ayardan alıyor. Yerel ayar `labels.locale`den; verilmezse
-     * biçimlendirme YAPILMAZ ve değer olduğu gibi yazılır. Yanlış yerel ayarda
-     * biçimlendirilmiş bir tutar, biçimlendirilmemiş olandan kötü: "1,250" bir
-     * yerde bin iki yüz elli, başka bir yerde bir tam iki yüz elli.
-     *
-     * <p>Para birimi simgesinin ÖN/ARKA konumu da yerel ayara bağlı ve şu anda
-     * her zaman arkada — `Intl` açıldığında doğru konumu o veriyor.
-     */
+    /** Değeri `Intl.NumberFormat` ile biçimlendirir. */
     isFormatted?: boolean;
     /** Üstü çizili liste fiyatı; indirim varsa verilir (biçimlenmiş). */
     listValue?: string;
@@ -2757,16 +1562,7 @@ declare type Props_28 = {
     value: number;
     /** Değerlendirme sayısı; verilirse yıldızların yanında gösterilir. */
     count?: number;
-    /**
-     * Ekran okuyucuya okunan metin.
-     *
-     * <p>Yıldızlar `aria-hidden`: beş ayrı ikonu tek tek duyurmak anlamsız.
-     * Yerine bir cümle okunur ("5 üzerinden 4,5 — 12 değerlendirme") ve o cümle
-     * hem dile hem sayı biçimine bağlı; kütüphane onu uyduramaz.
-     *
-     * <p>Verilmezse `labels.rating.srLabel(value, count)` çağrılır — cümle
-     * değere bağlı olduğu için config bir DİZE değil bir biçimlendirici tutar.
-     */
+    /** Ekran okuyucuya okunan metin. */
     srLabel?: string;
     size?: 'sm' | 'md';
     className?: string;
@@ -2815,13 +1611,7 @@ declare type Props_3 = {
 
 declare type Props_30 = {
     children: ReactNode;
-    /**
-     * Kaydırılabilir bölgenin erişilebilir adı. ZORUNLU.
-     *
-     * <p>Bölge klavyeyle odaklanabilir olduğunda ekran okuyucu onu duyuruyor;
-     * adsız bir bölge "bölge" diye okunuyor ve kullanıcı neyin içinde olduğunu
-     * bilmiyordu.
-     */
+    /** Kaydırılabilir bölgenin erişilebilir adı. ZORUNLU. */
     label: string;
     /** Kaydırma yönü. `both` iki eksende de kaydırır. */
     axis?: 'vertical' | 'horizontal' | 'both';
@@ -2853,20 +1643,9 @@ declare type Props_32 = {
     unit?: string;
     /** Değişim metni ("%12", "+3"). `trend` ile birlikte anlamlı. */
     delta?: string;
-    /**
-     * Değişimin yönü.
-     *
-     * <p>Yön TEK BAŞINA iyi/kötü demek değildir: "iade oranı %12 arttı" kötü,
-     * "ciro %12 arttı" iyi. Renk kararı {@link isUpPositive} ile ayrı veriliyor.
-     */
+    /** Değişimin yönü. */
     trend?: StatTrend;
-    /**
-     * Artış İYİ mi. Varsayılan `true`.
-     *
-     * <p>`false` verildiğinde yukarı ok kırmızı, aşağı ok yeşil çizilir — iade
-     * oranı, hata sayısı, terk edilen sepet gibi ölçüler için. Yönü her zaman
-     * yeşil çizmek, kötüleşen bir ölçüyü iyi haber gibi gösteriyordu.
-     */
+    /** Artış İYİ mi. Varsayılan `true`. */
     isUpPositive?: boolean;
     /** Değerin altındaki bir cümlelik bağlam ("geçen haftaya göre"). */
     description?: ReactNode;
@@ -2875,15 +1654,6 @@ declare type Props_32 = {
     /**
      * `plain` KUTUYU kaldırır: zemin, kenarlık ve dolgu gider, yalnızca sayı
      * kalır. Varsayılan `card`.
-     *
-     * <p>Kendi zemini olan bir bandın (kahraman, güvence şeridi) üzerinde
-     * ölçümler kart olarak istenmiyor. Bunun tek yolu kapsayıcıda
-     * `--hanui-surface: transparent` yazmaktı ve iki şeyi birden bozuyordu:
-     * dolgu <em>görünmez oluyor ama YER KAPLIYOR</em> — ölçüldü, telefonda 2×2
-     * ızgarada satır arası 48 px'e çıkıyor ve dört sayı tek bir grup gibi
-     * okunmuyordu — ayrıca o değişken kapsayıcıdaki <strong>her</strong> hanui
-     * yüzeyini birden düzleştiriyordu. `plain` niyeti tek yerde söyler ve
-     * yüzey değişkenine dokunmaya gerek bırakmaz.
      */
     variant?: 'card' | 'plain';
     size?: 'sm' | 'md';
@@ -2901,13 +1671,7 @@ declare type Props_33 = {
     max?: number;
     /** Çubuğun erişilebilir adı ("Yükleme", "Ödeme adımı"). ZORUNLU. */
     label: string;
-    /**
-     * Ekran okuyucuya okunan METİN karşılığı ("3 / 5 dosya").
-     *
-     * <p>Verilmezse ekran okuyucu ham yüzdeyi okur. Bir dosya yüklemesinde
-     * "yüzde altmış" ile "5 dosyadan 3'ü" arasındaki fark, kullanıcının
-     * bekleyip beklememeye karar verebilmesi.
-     */
+    /** Ekran okuyucuya okunan METİN karşılığı ("3 / 5 dosya"). */
     valueText?: string;
     /** Yüzdeyi çubuğun yanında GÖRÜNÜR olarak yazar. */
     isValueVisible?: boolean;
@@ -2919,28 +1683,14 @@ declare type Props_33 = {
 
 declare type Props_34 = {
     size?: 'sm' | 'md' | 'lg';
-    /**
-     * Ekran okuyucuya okunacak metin; görsel olarak gizli.
-     *
-     * <p>Verilmezse `labels.loading` okunur. Boş dizeye BİLİNÇLİ olarak izin
-     * verilir: göstergenin <em>zaten adı olan</em> bir öğenin içinde durduğu
-     * yerlerde (yükleniyor durumundaki bir düğme) duyurmak tekrar üretiyor.
-     * `label=""` orada doğru olan ve config'i de bastırır.
-     */
+    /** Ekran okuyucuya okunacak metin; görsel olarak gizli. */
     label?: string;
     className?: string;
 };
 
 declare type Props_35 = {
     items: AccordionItem[];
-    /**
-     * Aynı anda YALNIZCA BİR bölüm açık kalır.
-     *
-     * <p>Varsayılan çoklu: bir SSS listesinde iki soruyu yan yana okumak
-     * yaygın bir ihtiyaç ve tek-açık kip, kullanıcının az önce açtığı bölümü
-     * habersizce kapatıyordu. Tek-açık yalnızca bölümler UZUN olduğunda
-     * (mobil filtre paneli) doğru.
-     */
+    /** Aynı anda YALNIZCA BİR bölüm açık kalır. */
     isSingle?: boolean;
     /** Kontrolsüz kullanımda açılışta açık olan bölümler. */
     defaultOpenIds?: string[];
@@ -2972,26 +1722,12 @@ declare type Props_37 = {
     items: TabItem[];
     /** Kontrolsüz kullanımda açılışta seçili sekme. */
     defaultTabId?: string;
-    /**
-     * Kontrollü kullanım: seçili sekme çağıranın durumunda.
-     *
-     * <p>`onChange` ile birlikte verilir. Kontrolsüz sürüm (yalnızca
-     * `defaultTabId`) korunur — kendi durumunu tutması yeterli olan sekmelerin
-     * dışarıdan yönetilmesi gereksiz.
-     */
+    /** Kontrollü kullanım: seçili sekme çağıranın durumunda. */
     activeId?: string;
     onChange?: (id: string) => void;
     /** Sekme çubuğunun erişilebilir adı. */
     ariaLabel?: string;
-    /**
-     * Ok tuşu yalnızca ODAĞI taşır; seçim `Enter`/`Space` ile yapılır.
-     *
-     * <p>Varsayılan OTOMATİK etkinleştirme (ok tuşu odakla birlikte seçimi de
-     * taşır) ve APG panel içeriği hazır olduğu sürece onu öneriyor. Ama panel
-     * PAHALIYSA — her sekme bir istek atıyorsa — otomatik etkinleştirme,
-     * kullanıcı beşinci sekmeye giderken dört istek atıyor. Manuel kipte
-     * kullanıcı hedefine varıp `Enter`a basıyor: tek istek.
-     */
+    /** Ok tuşu yalnızca ODAĞI taşır; seçim `Enter`/`Space` ile yapılır. */
     isManualActivation?: boolean;
     className?: string;
     testId?: string;
@@ -3044,14 +1780,7 @@ declare type Props_40 = {
     toolbar?: ReactNode;
     /** Dipte duran eylem şeridi. */
     footer?: ReactNode;
-    /**
-     * Panelin <strong>kendiliğinden kapandığı</strong> medya sorgusu.
-     *
-     * <p>Varsayılan mobil eşiği (`>640`), çünkü seçim kutuları o eşiğin üstünde
-     * listeyi yapışkan panelde açıyor. Kendi eşiği daha geniş olan çağıranlar
-     * kendi sorgusunu verir; aksi hâlde 800 px'te açılan panel pencere 641 px'i
-     * geçtiğinde kapanıyor ya da hiç kapanmıyordu.
-     */
+    /** Panelin <strong>kendiliğinden kapandığı</strong> medya sorgusu. */
     closeAbove?: string;
     className?: string;
     testId?: string;
@@ -3061,21 +1790,10 @@ declare type Props_41 = {
     isOpen: boolean;
     onClose: () => void;
     title: string;
-    /**
-     * Kapatma düğmesinin erişilebilir adı.
-     *
-     * <p>Verilmezse `HanuiProvider labels.close` okunur. Bağlama göre farklı
-     * olması gereken pencerelerde ("Daha sonra") prop kazanır.
-     */
+    /** Kapatma düğmesinin erişilebilir adı. */
     closeLabel?: string;
     children?: ReactNode;
-    /**
-     * Başlığın altındaki bir cümlelik açıklama.
-     *
-     * <p>`aria-describedby` ile pencereye bağlanır: ekran okuyucu pencere
-     * açıldığında başlıkla birlikte bunu da okur. Gövdeye paragraf olarak
-     * yazıldığında duyurulmuyordu.
-     */
+    /** Başlığın altındaki bir cümlelik açıklama. */
     description?: ReactNode;
     /** Altta duran eylemler. Sağa yaslanır; dar ekranda tam genişliğe yayılır. */
     footer?: ReactNode;
@@ -3084,13 +1802,7 @@ declare type Props_41 = {
     /** İkon madalyonunun tonu. */
     tone?: ModalTone;
     size?: 'sm' | 'md' | 'lg';
-    /**
-     * `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz.
-     *
-     * <p>Yalnızca <strong>sürmekte olan</strong> bir işlem için: silme isteği
-     * gönderilmişken pencerenin kapanması, kullanıcıya işlem iptal edilmiş gibi
-     * görünüyordu.
-     */
+    /** `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz. */
     isDismissable?: boolean;
     className?: string;
     testId?: string;
@@ -3116,36 +1828,19 @@ declare type Props_43 = {
     /**
      * Onaylandığında çalışır. `Promise` dönerse düğme beklerken yükleme
      * durumuna geçer ve pencere <strong>kapanmaz</strong>.
-     *
-     * <p>İşlem başarılıysa pencereyi kapatmak çağıranın işi: hata durumunda
-     * pencerenin açık kalması gerekiyor ki kullanıcı tekrar deneyebilsin.
      */
     onConfirm: () => void | Promise<void>;
     /** Soru cümlesi. Eylem odaklı yazılır: "…silinsin mi?". */
     title: string;
     /** Sonucu açıklar: neyin geri alınamaz olduğu burada yazılır. */
     description?: ReactNode;
-    /**
-     * Onay düğmesinin etiketi — ZORUNLU, config'ten okunmaz.
-     *
-     * <p>Eylemi TEKRARLAR: "Sil", "İptal et". Her pencerede farklı olduğu için
-     * uygulama düzeyinde bir varsayılanı olamaz; "Tamam" gibi bir varsayılan
-     * kullanıcıya neyi onayladığını söylemez ve `window.confirm()`ten kaçmamızın
-     * sebeplerinden biri tam olarak buydu.
-     */
+    /** Onay düğmesinin etiketi — ZORUNLU, config'ten okunmaz. */
     confirmLabel: string;
     /** Verilmezse `labels.cancel`. */
     cancelLabel?: string;
     /** Verilmezse `labels.close`. */
     closeLabel?: string;
-    /**
-     * Onayın türü — ikon, ton ve onay düğmesinin varyantını birlikte belirler.
-     *
-     * <p>Ad `kind`ten `variant`a taşındı: aynı işi yapan üçüncü bir ad
-     * kütüphanede zaten `variant` olarak duruyordu (`Button`, `Badge`) ve
-     * tüketici her bileşende hangisinin geçerli olduğunu hatırlamak zorunda
-     * kalıyordu. Nöbetçi: `src/__tests__/api-consistency.test.ts`.
-     */
+    /** Onayın türü — ikon, ton ve onay düğmesinin varyantını birlikte belirler. */
     variant?: ConfirmKind;
     /** @deprecated `variant` kullanın. Bir sonraki büyük sürümde kalkacak. */
     kind?: ConfirmKind;
@@ -3160,12 +1855,7 @@ declare type Props_44 = {
     /** Kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
     closeLabel?: string;
     children: ReactNode;
-    /**
-     * Panelin hangi kenardan geldiği. Mantıksal: `end` RTL'de sola açılır.
-     *
-     * <p>Varsayılan `end` — filtre ve ayrıntı panelleri okuma yönünün SONUNDAN
-     * gelir; `start` gezinme panelleri içindir.
-     */
+    /** Panelin hangi kenardan geldiği. Mantıksal: `end` RTL'de sola açılır. */
     side?: 'start' | 'end';
     size?: 'sm' | 'md' | 'lg';
     /** Dipte duran eylem şeridi; gövde kaydırılırken yerinde kalır. */
@@ -3179,13 +1869,7 @@ declare type Props_44 = {
 declare type Props_45 = BaseProps_3 & {
     /** Boş (yalnızca boşluk dahil) değer gönderilemez. */
     isRequired?: boolean;
-    /**
-     * Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)").
-     *
-     * <p>Yıldız yalnızca GÖRSEL bir kısayol; renk ve şekil tek başına anlam
-     * taşıyamaz (WCAG 1.4.1), o yüzden yanında okunabilir bir metin olmak
-     * zorunda. Verilmezse `labels.required` okunur.
-     */
+    /** Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)"). */
     requiredLabel?: string;
 };
 
@@ -3234,22 +1918,9 @@ declare type Props_47 = {
      * gidiyordu.
      */
     hasViewportCap?: boolean;
-    /**
-     * Sıralanabilir bir başlığa basıldığında çağrılır.
-     *
-     * <p>Sıralamanın KENDİSİ burada yapılmaz: veri çağıranın ve sıralama
-     * neredeyse her zaman sunucuda (sayfalanmış bir listede istemcide sıralamak
-     * yalnızca görünen sayfayı sıralar — kullanıcı "en ucuz" dediğinde en ucuz
-     * 24 ürünü değil, o sayfadaki en ucuzu görüyordu).
-     */
+    /** Sıralanabilir bir başlığa basıldığında çağrılır. */
     onSort?: (key: string, direction: 'ascending' | 'descending') => void;
-    /**
-     * Satır seçildiğinde beliren TOPLU EYLEM şeridi.
-     *
-     * <p>Tablonun ÜSTÜNDE ve yapışkan: kullanıcı yüzlerce satır arasında
-     * seçim yapıp aşağı kaydırdığında eylem şeridi ekranın dışında kalıyor ve
-     * seçimin ne işe yaradığı görünmüyordu.
-     */
+    /** Satır seçildiğinde beliren TOPLU EYLEM şeridi. */
     bulkBar?: ReactNode;
     className?: string;
     testId?: string;
@@ -3294,38 +1965,6 @@ declare type Props_5 = {
 declare type Props_6<T extends string> = SingleProps<T> | MultipleProps<T>;
 
 declare type Props_7<T extends string> = {
-    options: ComboboxOption<T>[];
-    value: T | null;
-    onChange: (value: T | null) => void;
-    labels: ComboboxLabels;
-    /**
-     * Verilirse arama <strong>sunucuda</strong> yapılır: bileşen listeyi kendisi
-     * filtrelemez, yazılanı 300 ms bekleyip buraya bildirir. Verilmezse
-     * filtreleme yerelde ve aksan duyarsız yapılır.
-     */
-    onSearch?: (query: string) => void;
-    isLoading?: boolean;
-    isDisabled?: boolean;
-    /** Seçimi kaldıran çarpı düğmesi gösterilir. */
-    isClearable?: boolean;
-    /**
-     * Arama kutusu GİZLENİR.
-     *
-     * <p>Az sayıda, sabit seçenekli listelerde arama bir işe yaramıyor: altı
-     * satırı taramak yazmaktan hızlı ve kutu açılışta odağı çalıp mobilde
-     * klavyeyi açıyordu. Ok tuşlarıyla gezinme ve `Escape` yine çalışır.
-     */
-    isSearchHidden?: boolean;
-    /** Tetikleyicinin solundaki ikon. */
-    icon?: ReactNode;
-    id?: string;
-    'aria-describedby'?: string;
-    'aria-invalid'?: boolean;
-    className?: string;
-    testId?: string;
-};
-
-declare type Props_8<T extends string> = {
     options: SegmentOption<T>[];
     value: T;
     onChange: (value: T) => void;
@@ -3338,17 +1977,13 @@ declare type Props_8<T extends string> = {
     testId?: string;
 };
 
-declare type Props_9<T extends string> = {
+declare type Props_8<T extends string> = {
     options: SelectOption<T>[];
     value: T;
     onChange: (value: T) => void;
     /**
      * Alanın adı. İki işi birden yapar: alt sayfanın başlığı olur ve
      * tetikleyicinin <strong>erişilebilir adı</strong>dır.
-     *
-     * <p>Tetikleyici bir `<button>` ve düğmenin adı HTML-AAM'e göre
-     * `<label>`den GELMEZ — görünür bir etiket olsa bile ekran okuyucu yalnızca
-     * seçili değeri okur ("En yeni, düğme") ve neyi seçtiğini söylemez.
      */
     label: string;
     /** Seçim yokken tetikleyicide görünen metin. Verilmezse `labels.selectPlaceholder`. */
@@ -3359,12 +1994,7 @@ declare type Props_9<T extends string> = {
     icon?: ReactNode;
     /** `sm` yoğun şeritler içindir (araç çubuğu); varsayılan form ölçüsü `md`. */
     size?: 'sm' | 'md';
-    /**
-     * Panelin hangi kenardan hizalanacağı.
-     *
-     * <p>Şeridin sağ ucundaki bir tetikleyicide `start` hizalama paneli sağa
-     * doğru taşırıyordu; `end` panelin sağ kenarını tetikleyiciye yaslar.
-     */
+    /** Panelin hangi kenardan hizalanacağı. */
     align?: 'start' | 'end';
     isDisabled?: boolean;
     id?: string;
@@ -3374,32 +2004,25 @@ declare type Props_9<T extends string> = {
     testId?: string;
 };
 
+declare type Props_9 = {
+    /** Radyo grubu adı — aynı gruptaki kartlar ok tuşlarıyla gezilir. */
+    name: string;
+    value: string;
+    isSelected: boolean;
+    isDisabled?: boolean;
+    onChange: (value: string) => void;
+    /** Zengin gövde: kartın içeriği çağırana aittir. */
+    children: ReactNode;
+} & CommonElementProps;
+
 export declare const QuantityStepper: typeof QuantityStepper_2;
 
-/**
- * Adet seçici.
- *
- * <p>Doğrudan yazma da desteklenir: 12 adet isteyen kullanıcının artı düğmesine
- * on iki kez basması kabul edilemez.
- *
- * <p>Yazılan değer <strong>odak kaybında</strong> sınırlara çekilir, her tuş
- * vuruşunda değil: "12" yazarken "1"i anında 1'e sabitlemek kullanıcının
- * yazmasını engellerdi.
- */
-declare const QuantityStepper_2: FC<Props_13>;
+/** Adet seçici. */
+declare const QuantityStepper_2: FC<Props_12>;
 
 export declare const Radio: typeof Radio_2;
 
-/**
- * Radyo düğmesi.
- *
- * <p>{@link Checkbox} ile aynı gerekçe: yerel `<input type="radio">` korunur
- * ve `accent-color` ile renklendirilir. Sahte bir daire çizmek ok tuşlarıyla
- * gezinmeyi ve grup duyurusunu elle yeniden kurmayı gerektirirdi.
- *
- * <p>Tüm satır tıklanabilir (`<label>` sarmalar): 18 px'lik daireyi
- * hedeflemek özellikle dokunmatik ekranda yorucu.
- */
+/** Radyo düğmesi. */
 declare const Radio_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
 label: ReactNode;
 hint?: string;
@@ -3410,32 +2033,8 @@ testId?: string;
 
 export declare const RadioCard: typeof RadioCard_2;
 
-/**
- * Seçilebilir kart — zengin gövdeli radyo.
- *
- * <h3>Neden ayrı bir öğe</h3>
- * Varyant seçici ve hesap seçici aynı deseni elle kuruyordu: `<label>` + gizli
- * radyo + gövde + seçili/pasif durum matrisi. İki kopya çoktan ayrışmıştı —
- * biri odak halkasını metnin üstüne, diğeri hiç çizmiyordu; biri seçili zemini
- * boyuyor, diğeri boyamıyordu.
- *
- * <h3>Radyo GERÇEK, daire çizim</h3>
- * `<input type="radio">` görsel olarak gizlenir ama DOM'da kalır: ok
- * tuşlarıyla grup içinde gezinme, `Space` ile seçim ve ekran okuyucu duyurusu
- * tarayıcıdan gelir. Yerel daire bu boyutta bir kartta görsel olarak
- * kaybolduğu için işaret ayrıca çizilir (`__indicator`).
- *
- * <h3>Seçim üç sinyalle</h3>
- * Kenarlık + zemin tinti + dolan işaret aynı anda değişir. İşaretin dolu / boş
- * hâli bir BİÇİM farkıdır — renk tek başına anlam taşımaz (WCAG 1.4.1).
- *
- * <p>Odak halkası kartın kendisinde (`:has(:focus-visible)`): gizli girdiye
- * çizilen halka görünmüyor, yalnızca metne çizilen halka da kartın nerede
- * bittiğini söylemiyordu.
- *
- * <p>{@link Radio} yalın satır içindir, gövde taşıyamaz — ikisi karışmaz.
- */
-declare const RadioCard_2: FC<Props_10>;
+/** Seçilebilir kart — zengin gövdeli radyo. */
+declare const RadioCard_2: FC<Props_9>;
 
 declare type RangeProps = {
     value: DateRangeValue;
@@ -3458,86 +2057,20 @@ declare type RangeProps = {
 
 export declare const RangeSlider: typeof RangeSlider_2;
 
-/**
- * Çift kulplu aralık kaydırıcı.
- *
- * <h3>Neden iki gerçek `<input type="range">`</h3>
- * Kulplar `<div>` ile çizilip sürükleme JavaScript'le yazıldığında klavye
- * desteği, ekran okuyucu duyurusu ve dokunma davranışı elle yeniden kurulmak
- * zorunda kalır — ve pratikte biri hep eksik kalır. Üst üste bindirilmiş iki
- * yerel aralık girdisi bunların hepsini ücretsiz getirir: ok tuşları, Home/End,
- * PageUp/PageDown ve aralık duyurusu kendiliğinden çalışır.
- *
- * <h3>Kulplar birbirini geçemez</h3>
- * Alt kulp üst değeri, üst kulp alt değeri aşamaz. Geçmelerine izin vermek
- * "en az 8.000, en çok 1.200" gibi anlamsız bir aralık üretiyordu.
- *
- * <h3>Sayı değil METİN duyurulur</h3>
- * `aria-valuetext` biçimlenmiş değeri taşır. Aksi hâlde ekran okuyucu ham
- * sayıyı ("bir milyon iki yüz elli bin") okuyordu.
- *
- * <h3>`onChange` ile `onCommit` ayrıdır</h3>
- * Kaydırırken her adımda adres çubuğuna yazmak, tek bir sürüklemede onlarca
- * gezinme kaydı bırakıp geri tuşunu kullanılamaz hâle getiriyordu. Ekran anında
- * güncellenir (`onChange`), sorgu yalnızca kulp bırakılınca yazılır.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`ArrowRight` / `ArrowUp`</td><td>bir adım artırır</td></tr>
- *   <tr><td>`ArrowLeft` / `ArrowDown`</td><td>bir adım azaltır</td></tr>
- *   <tr><td>`Home` / `End`</td><td>ölçeğin ucuna gider</td></tr>
- *   <tr><td>`PageUp` / `PageDown`</td><td>büyük adım</td></tr>
- * </table>
- * Tamamı YEREL öğeden gelir — kütüphane hiçbir tuşu kendisi işlemez. Buraya
- * ait olan iki şey ayrıca ölçülüyor: kulpların birbirini geçmemesi ve
- * `onCommit`in tuş bırakıldığında (`keyup`) çalışması. Nöbetçi:
- * `components/__tests__/keyboard.test.tsx`.
- */
-declare const RangeSlider_2: ({ min, max, step, value, onChange, onCommit, formatValue, label, minLabel, maxLabel, isDisabled, className, testId, }: Props_11) => JSX.Element;
+/** Çift kulplu aralık kaydırıcı. */
+declare const RangeSlider_2: ({ min, max, step, value, onChange, onCommit, formatValue, label, minLabel, maxLabel, isDisabled, className, testId, }: Props_10) => JSX.Element;
 
 export declare type RangeValue = [number, number];
 
 export declare const Rating: typeof Rating_2;
 
-/**
- * Yıldız puanı — salt gösterim.
- *
- * <p>Ortalama sunucuda hesaplanır; burada yalnızca gösterilir. Puanı
- * istemcide hesaplamak, sayfalama yüzünden eksik veriyle yanlış ortalama
- * üretirdi.
- *
- * <p>Etkileşimli kardeşi {@link RatingInput}.
- */
+/** Yıldız puanı — salt gösterim. */
 declare const Rating_2: FC<Props_28>;
 
 export declare const RatingInput: typeof RatingInput_2;
 
-/**
- * Yıldızla puan girişi.
- *
- * <h3>Beş gerçek radyo düğmesi</h3>
- * Yıldızlar `<span>` ile çizilip tıklama JavaScript'e bağlanabilirdi. Bunun
- * yerine `<fieldset>` içinde beş yerel `<input type="radio">` kullanılır ve
- * yıldız görünümü etiketlerine verilir. Böylece ok tuşlarıyla gezinme, Tab
- * davranışı, ekran okuyucuda "5 seçenekten 4'ü seçili" duyurusu ve form
- * gönderimine katılma <em>bedava</em> gelir.
- *
- * <p>{@link Rating} genişletilemez: o `<span>` üretiyor ve açıkça
- * salt-gösterim. İkisini tek bileşende toplamak, gösterim tarafına hiç
- * kullanılmayan etkileşim kodu taşımak olurdu.
- *
- * <h3>Klavye (APG: radio group — tamamı YEREL)</h3>
- * <table>
- *   <tr><td>`ArrowRight` / `ArrowDown`</td><td>bir sonraki yıldız</td></tr>
- *   <tr><td>`ArrowLeft` / `ArrowUp`</td><td>bir önceki yıldız</td></tr>
- *   <tr><td>`Tab`</td><td>grubu TEK durak olarak geçer</td></tr>
- * </table>
- * Kütüphane hiçbir tuşu işlemiyor; nöbetçi bu yüzden tuşları değil DEVRİ
- * ölçüyor — beş gerçek radyo, tek grup adı, okunabilir adlar
- * (`components/__tests__/keyboard.test.tsx`). Yıldızlar `<span>`e dönerse
- * test kırılır.
- */
-declare const RatingInput_2: ({ value, onChange, label, ratingLabels, formatStarCount, isDisabled, className, testId, }: Props_12) => JSX.Element;
+/** Yıldızla puan girişi. */
+declare const RatingInput_2: ({ value, onChange, label, ratingLabels, formatStarCount, isDisabled, className, testId, }: Props_11) => JSX.Element;
 
 /** Beş puanın her birinin ne anlama geldiği. */
 export declare type RatingLabels = Record<1 | 2 | 3 | 4 | 5, string>;
@@ -3547,47 +2080,13 @@ export declare const resolveTokens: (scheme: HanuiColorScheme, config?: HanuiThe
 
 declare type RowProps = HTMLAttributes<HTMLTableRowElement> & {
     children: ReactNode;
-    /**
-     * Satır dikkat bekleyen iş taşıyor (kritik stok, karar bekleyen talep).
-     *
-     * <p>TEK desen: tint zemin + ilk hücrede sol kenar işareti. Önceden iki
-     * uygulama vardı — yalnız düz uyarı zemini ve zemin + sol iç gölge. Zemin
-     * tek başına yetmiyordu: hover vurgusu tinti ezince satırın "iş bekliyor"
-     * bilgisi kayboluyordu ve renk tek başına zaten anlam taşıyamaz (WCAG
-     * 1.4.1) — sol işaret hover'da da yerinde kalır.
-     */
+    /** Satır dikkat bekleyen iş taşıyor (kritik stok, karar bekleyen talep). */
     isWarning?: boolean;
 };
 
 export declare const ScrollArea: typeof ScrollArea_2;
 
-/**
- * Kaydırma kutusu — <strong>klavyeyle erişilebilir</strong> kaydırma bölgesi.
- *
- * <h3>Neden bir bileşen: `overflow: auto` TEK BAŞINA yetmiyor</h3>
- * Kaydırılabilir bir bölge klavyeyle ulaşılabilir olmak zorunda (WCAG 2.1.1).
- * İçinde odaklanabilir öğe olmayan bir kutu — uzun bir metin, bir tablo, bir
- * kod bloğu — `tabindex` verilmediğinde klavye kullanıcısı için
- * <strong>ulaşılamaz</strong>: `Tab` onu atlıyor ve ok tuşları sayfayı
- * kaydırıyor, kutuyu değil. Firefox bunu kendiliğinden yapıyor, Chrome ve
- * Safari yapmıyor.
- *
- * <p>Ama `tabindex="0"` KOŞULSUZ verilemez: içerik sığdığında kutu
- * kaydırılamaz olur ve gereksiz bir `Tab` durağına dönüşür. Bileşen taşmayı
- * ÖLÇÜYOR ve `tabindex`i yalnızca gerçekten kaydırılabilirken yazıyor.
- *
- * <h3>Kaydırma çubuğu temalı</h3>
- * İşletim sisteminin açık çubuğu koyu temada kutunun kenarında parlak bir
- * şerit bırakıyordu.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Tab`</td><td>kaydırılabilir bölgeye odaklanır (yalnızca taşma varsa)</td></tr>
- *   <tr><td>ok tuşları · `PageUp`/`PageDown` · `Home`/`End`</td><td>kaydırır</td></tr>
- * </table>
- * Tuşların hepsi TARAYICIDAN geliyor; bileşenin işi yalnızca bölgeyi
- * odaklanabilir kılmak.
- */
+/** Kaydırma kutusu — <strong>klavyeyle erişilebilir</strong> kaydırma bölgesi. */
 declare const ScrollArea_2: FC<Props_30>;
 
 declare type ScrollerProps = HTMLAttributes<HTMLDivElement> & {
@@ -3601,52 +2100,13 @@ declare type ScrollerProps = HTMLAttributes<HTMLDivElement> & {
 
 export declare const SectionHeader: typeof SectionHeader_2;
 
-/**
- * Bölüm başlığı.
- *
- * <p>Başlık düzeyi (`as`) görsel boyuttan (`size`) <strong>ayrı</strong>:
- * sayfa hiyerarşisi anlamsal olmak zorunda ama görsel boyut bağlamla değişir.
- * İkisini birbirine bağlamak, doğru görünüm için yanlış başlık düzeyi seçmeye
- * zorlardı.
- */
+/** Bölüm başlığı. */
 declare const SectionHeader_2: FC<Props_29>;
 
 export declare const SegmentedControl: typeof SegmentedControl_2;
 
-/**
- * Bölmeli denetim — <strong>görünüm</strong> değiştirme.
- *
- * <h3>{@link ChipGroup} ile farkı: filtre mi görünüm mü</h3>
- * İkisi de `radiogroup` ve ikisi de tek seçim; ayrım seçilen şeyin ne
- * olduğunda:
- *
- * <ul>
- *   <li>`ChipGroup` bir FİLTRE. Seçim listeyi daraltıyor, seçenek sayısı
- *       değişken ve "hiçbiri" geçerli bir durum — çipe ikinci kez basmak
- *       seçimi kaldırıyor.</li>
- *   <li><b>`SegmentedControl` bir GÖRÜNÜM anahtarı.</b> Liste/ızgara,
- *       aylık/yıllık, gelen/giden. Seçenek sayısı 2-4 ve SABİT; <strong>seçili
- *       durum her zaman tektir</strong> — "hiçbiri" diye bir hâl yok, çünkü
- *       ekranda bir şey çizilmek zorunda.</li>
- * </ul>
- *
- * <p>Bu yüzden seçili öğeye ikinci kez basmak hiçbir şey yapmaz; `ChipGroup`ta
- * aynı hareket seçimi kaldırıyor. Aynı bileşeni iki iş için kullanmak, bu
- * davranış farkını kaybetmek olurdu.
- *
- * <h3>Neden `Tabs` değil</h3>
- * `Tabs` bir PANEL değiştirir ve `aria-controls` ile ona bağlanır; bölmeli
- * denetim aynı içeriğin başka bir SUNUMUNU seçiyor — gösterilen veri aynı.
- * Sekme olarak sunmak ekran okuyucuya var olmayan bir panel vaat ediyordu.
- *
- * <h3>Klavye (APG: radio group)</h3>
- * <table>
- *   <tr><td>`ArrowRight` / `ArrowDown`</td><td>sonraki seçenek; uçlarda DÖNER</td></tr>
- *   <tr><td>`ArrowLeft` / `ArrowUp`</td><td>önceki seçenek</td></tr>
- *   <tr><td>`Tab`</td><td>grubu TEK durak olarak geçer (dönen `tabindex`)</td></tr>
- * </table>
- */
-declare const SegmentedControl_2: <T extends string>({ options, value, onChange, label, isIconOnly, size, className, testId, }: Props_8<T>) => JSX.Element;
+/** Bölmeli denetim — <strong>görünüm</strong> değiştirme. */
+declare const SegmentedControl_2: <T extends string>({ options, value, onChange, label, isIconOnly, size, className, testId, }: Props_7<T>) => JSX.Element;
 
 export declare type SegmentOption<T extends string = string> = {
     value: T;
@@ -3658,43 +2118,8 @@ export declare type SegmentOption<T extends string = string> = {
 
 export declare const Select: typeof Select_2;
 
-/**
- * Seçim kutusu.
- *
- * <h3>Yerel `<select>` KULLANILMAZ</h3>
- * Yerel açılır liste her tarayıcıda başka türlü çiziliyor, seçeneklerine tek
- * bir stil verilemiyor (seçili değeri işaretlemek, ikon koymak, satırı
- * yükseltmek yok) ve mobilde ekranın ortasında beliren tekerlek uygulamanın
- * geri kalanına hiç benzemiyordu. Kutu baştan sona bizim: masaüstünde
- * tetikleyicinin altında bir panel, mobilde ekranın dibinden yükselen bir
- * <strong>alt sayfa</strong> açar.
- *
- * <p>Bu, "yerel öğe taklit öğeden iyidir" kuralının BİLİNÇLİ tek istisnası:
- * bedeli (odak yönetimi, ok tuşları, `aria-activedescendant`) bir kez ödenip
- * tek bileşene kapatıldı.
- *
- * <h3>Klavye — odak TEK yerde</h3>
- * Panel açıkken odak tetikleyicide kalır, alt sayfada ise listenin kendisine
- * geçer; iki durumda da etkin seçenek `aria-activedescendant` ile bildirilir.
- * Seçenekleri tek tek odaklanabilir yapmak, aynı bileşende iki ayrı klavye
- * modeli demekti (APG: listbox + activedescendant).
- *
- * <table>
- *   <tr><td>`ArrowDown`/`ArrowUp`/`Enter`/`Space` (kapalıyken)</td><td>paneli açar</td></tr>
- *   <tr><td>`ArrowDown` / `ArrowUp`</td><td>etkin seçenek bir alt/üst; uçlarda DÖNER</td></tr>
- *   <tr><td>`Home` / `End`</td><td>ilk / son seçenek</td></tr>
- *   <tr><td>`Enter` / `Space`</td><td>etkin seçeneği seçer</td></tr>
- *   <tr><td>`Escape`</td><td>seçim yapmadan kapatır, odak tetikleyicide</td></tr>
- *   <tr><td>`Tab`</td><td>kapatır, gezinme sürer</td></tr>
- * </table>
- * Etkin seçenek açılışta SEÇİLİ olandan başlar. Nöbetçi:
- * `components/__tests__/keyboard.test.tsx`.
- *
- * <h3>20+ seçenek varsa bu bileşen DEĞİL</h3>
- * Aramasız bir liste 20 satırdan sonra taranamaz hâle gelir; orada
- * {@link Combobox} kullanılır.
- */
-declare const Select_2: <T extends string>({ options, value, onChange, label, placeholder, closeLabel, icon, size, align, isDisabled, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_9<T>) => JSX.Element;
+/** Seçim kutusu. */
+declare const Select_2: <T extends string>({ options, value, onChange, label, placeholder, closeLabel, icon, size, align, isDisabled, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_8<T>) => JSX.Element;
 
 export declare type SelectOption<T extends string = string> = {
     value: T;
@@ -3717,17 +2142,7 @@ declare type SingleProps<T extends string> = BaseProps<T> & {
 
 export declare const Skeleton: typeof Skeleton_2;
 
-/**
- * Yükleme iskeleti.
- *
- * <h3>Neden dönen çark yerine iskelet</h3>
- * İskelet gelecek içeriğin <em>şeklini</em> gösterir; kullanıcı ne beklediğini
- * bilir ve içerik geldiğinde yerleşim kaymaz (CLS). Dönen bir çark hem konumu
- * hem boyutu belirsiz bırakır.
- *
- * <p>`aria-hidden`: ekran okuyucuya "yükleniyor" bilgisini veren, iskeletin
- * kendisi değil onu saran bölgenin `aria-busy` özelliğidir.
- */
+/** Yükleme iskeleti. */
 declare const Skeleton_2: FC<Props_31>;
 
 export declare const SkeletonCard: NamedExoticComponent<ShapeProps>;
@@ -3740,59 +2155,12 @@ columns?: number;
 
 export declare const Spinner: typeof Spinner_2;
 
-/**
- * Yükleme göstergesi.
- *
- * <p>İskelet (`Skeleton`) tercih edilir; bu bileşen yalnızca <em>şekli
- * bilinmeyen</em> bir bekleme için — düğme içi işlem veya belirsiz süreli bir
- * sorgu gibi.
- */
+/** Yükleme göstergesi. */
 declare const Spinner_2: FC<Props_34>;
 
 export declare const Stat: typeof Stat_2;
 
-/**
- * Ölçüm kutusu (KPI).
- *
- * <h3>Bileşen HESAP YAPMAZ</h3>
- * `value` ve `delta` biçimlendirilmiş dizeler. Yüzde hesabı, para birimi ve
- * yuvarlama çağıranın: bir gösterge panelinde "%12,5" ile "%13" arasındaki
- * farkı belirleyen şey ürün kararı, bileşenin varsayılanı değil. Aynı sebeple
- * `Price` de hesap yapmıyor.
- *
- * <h3>Yön TEK BAŞINA iyi/kötü demek DEĞİL</h3>
- * "İade oranı %12 arttı" kötü haber, "ciro %12 arttı" iyi. Yükselen her oku
- * yeşile boyamak, kötüleşen bir ölçüyü iyi gibi gösteriyordu — `isUpPositive`
- * bu kararı çağırana bırakıyor.
- *
- * <h3>Renk tek sinyal değil</h3>
- * Değişim üç şeyle birden anlatılıyor: <strong>ok yönü</strong> (biçim),
- * <strong>renk</strong> ve ekran okuyucuya okunan <strong>metin</strong>
- * ("artış" / "azalış" / "değişim yok"). Yalnızca renk kullanılsaydı renk körü
- * bir kullanıcı için artışla azalış aynı görünüyordu (WCAG 1.4.1).
- *
- * <h3>Rakamlar TABULAR</h3>
- * Alt alta duran ölçüm kutularında orantılı rakamlar sütunu tırtıklı
- * gösteriyor; `tabular-nums` her basamağı aynı genişlikte çiziyor.
- *
- * <h3>GENİŞLİK KARARI KAPSAYICININ</h3>
- * `Stat` kendine `flex` ya da `width` yazmaz ve bu bilinçli. Esnek bir sırada
- * içeriği kadar büzülür — yan yana dört kutu 148-177 px arasında tırtıklı
- * çıkabilir — ama çözüm kutuya `flex: 1` yazmak DEĞİL: aynı bileşen bir
- * ızgara hücresinde, bir kartın içinde ve tek başına da kullanılıyor ve orada
- * `flex: 1` çağıranın kararını sessizce eziyor. Eşit genişlik isteniyorsa
- * kapsayıcı söyler:
- *
- * ```scss
- * .stats { display: grid; grid-template-columns: repeat(auto-fit, minmax(160px, 1fr)); }
- * ```
- *
- * <h3>Kendi zemini olan bandın üzerinde: `variant="plain"`</h3>
- * Kart görünümü (zemin + kenarlık + dolgu) sayfa yüzeyi için. Bir kahraman
- * bandının içinde ölçümler kart olarak istenmediğinde `plain` verilir; zemini
- * `transparent`a çevirmek dolguyu <em>görünmez</em> yapar ama kaldırmaz ve
- * ızgara sessizce dağılır.
- */
+/** Ölçüm kutusu (KPI). */
 declare const Stat_2: FC<Props_32>;
 
 /** Değişimin yönü. `flat` "değişmedi" — yokluk DEĞİL. */
@@ -3807,35 +2175,7 @@ export declare type StepItem = {
 
 export declare const Steps: typeof Steps_2;
 
-/**
- * Adım göstergesi (stepper) — çok adımlı akışta NEREDE olunduğu.
- *
- * <h3>Üç durum, ÜÇ AYRI işaret</h3>
- * Tamamlanan adım <strong>tik</strong>, bulunulan adım <strong>dolu
- * madalyon + sıra numarası</strong>, sıradaki adım <strong>boş
- * madalyon</strong> taşıyor. Renk bunlara EŞLİK ediyor, tek başına
- * anlatmıyor (WCAG 1.4.1): üçünü yalnızca renkle ayırmak, renk körü bir
- * kullanıcı için "üç aynı daire" demekti.
- *
- * <p>Durum ayrıca METİN olarak okunuyor — her adımın erişilebilir adına
- * "tamamlandı" / "şu anki adım" / "sıradaki" ekleniyor. Görsel işaret ekran
- * okuyucuya geçmiyor; `aria-current` tek başına yalnızca BULUNULAN adımı
- * söylüyor, tamamlananları değil.
- *
- * <h3>Geri dönülebilirlik AÇIKÇA bildirilir</h3>
- * `onStepClick` verilmediğinde adımlar `<button>` bile değil: tıklanabilir
- * görünüp hiçbir şey yapmayan bir adım, kullanıcıya var olmayan bir yol vaat
- * ediyordu. Verildiğinde yalnızca TAMAMLANMIŞ adımlar tıklanabilir — ileri
- * atlamak, atlanan adımın verisini toplamadan devam etmek demek.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Tab`</td><td>tıklanabilir adımlar arasında gezinir</td></tr>
- *   <tr><td>`Enter` / `Space`</td><td>adıma döner</td></tr>
- * </table>
- * Ok tuşu YOK: adımlar bir seçim listesi değil, her biri bağımsız bir
- * gezinme bağlantısı.
- */
+/** Adım göstergesi (stepper) — çok adımlı akışta NEREDE olunduğu. */
 declare const Steps_2: FC<Props_36>;
 
 export declare const Switch: typeof Switch_2;
@@ -3843,48 +2183,12 @@ export declare const Switch: typeof Switch_2;
 /**
  * Anahtar (switch) — <strong>anında</strong> uygulanan aç/kapa.
  *
- * <h3>`Checkbox` ile farkı: NE ZAMAN etkili olduğu</h3>
- * İkisi de iki durumlu ve ikisi de yerel `<input type="checkbox">` üzerine
- * kurulu; ayrım görünüşte değil ZAMANLAMADA:
- *
- * <ul>
- *   <li>{@link Checkbox} bir formda <strong>gönderilecek</strong> seçimdir.
- *       "Sözleşmeyi okudum" işaretlendiğinde hiçbir şey olmaz; karar
- *       "Kaydet"e basıldığında geçerli olur. Geri almak için işareti kaldırıp
- *       yeniden göndermek gerekir.</li>
- *   <li><b>`Switch` ANINDA uygulanır.</b> "Kampanya bildirimleri" açıldığı
- *       anda sunucuya gider. Kaydet düğmesi yoktur, olmamalıdır da —
- *       kullanıcı anahtarı çevirdikten sonra bir düğme aramak zorunda
- *       kalıyordu.</li>
- * </ul>
- *
- * <p>Ayrım keyfi değil ekran okuyucuda DUYULUYOR: `role="switch"` "açık/kapalı"
- * diye okunur, onay kutusu "işaretli/işaretsiz" diye. İkisi kullanıcıya farklı
- * bir söz veriyor.
- *
- * <h3>Yerel öğe korunur</h3>
- * `<input type="checkbox" role="switch">` — `Space` ile değiştirme, `Tab`
- * sırası, form gönderimine katılma ve `:disabled` semantiği tarayıcıdan gelir.
- * `<div role="switch" tabindex="0">` yazmak bunların hepsini elle yeniden
- * kurmak demekti.
- *
- * <h3>Durum RENKLE ANLATILMAZ</h3>
- * Açık ve kapalı hâl arasındaki fark yalnızca zemin rengi olsaydı renk körü
- * bir kullanıcı için iki durum aynı görünürdü (WCAG 1.4.1). Kulp KONUM
- * değiştiriyor — bu bir biçim farkı — ve zorlanmış renk kipinde çerçeve +
- * konum tek başına yeterli kalıyor.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Space`</td><td>durumu değiştirir</td></tr>
- * </table>
- *
  * @example
  * <Switch
- *   label="Kampanya bildirimleri"
- *   hint="E-posta ile ayda en fazla iki ileti"
- *   checked={isSubscribed}
- *   onChange={event => subscribe(event.target.checked)}
+ * label="Kampanya bildirimleri"
+ * hint="E-posta ile ayda en fazla iki ileti"
+ * checked={isSubscribed}
+ * onChange={event => subscribe(event.target.checked)}
  * />
  */
 declare const Switch_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "role" | "type"> & {
@@ -3902,52 +2206,18 @@ export declare type TabItem = {
     label: string;
     /** Etiketin yanında gösterilen sayı. */
     count?: number;
-    /**
-     * Sekmenin paneli.
-     *
-     * <p>Verilmezse bileşen yalnızca <strong>sekme çubuğu</strong> çizer ve
-     * içeriği çağıran taraf yönetir. Bir formun üç kipi tek bir panelin içinde
-     * yaşıyorsa üç ayrı panel yazmak aynı alanları üç kez tanımlamak olurdu.
-     */
+    /** Sekmenin paneli. */
     content?: ReactNode;
 };
 
 export declare const Table: typeof Table_2;
 
-/**
- * Temel tablo — hairline satır ayrımı, `$surface-2` başlık, yoğunluk ölçeği.
- *
- * <p>Görsel kararlar (hangi hücre monospace, hangi sütun sabit) çağıranın
- * modülünde kalır; teknik değer hücresi `@include technical-text` ile
- * yazılır. Bileşen yalnızca üç tabloda üçe ayrışmış iskelet kurallarını tek
- * yerde toplar.
- *
- * <p>Operasyon ekranlarının durum satırlı (yükleniyor/hata/boş) sürümü için
- * {@link DataTable}.
- */
+/** Temel tablo — hairline satır ayrımı, `$surface-2` başlık, yoğunluk ölçeği. */
 declare const Table_2: FC<Props_46>;
 
 export declare const TableCheckbox: typeof TableCheckbox_2;
 
-/**
- * Tablo hücresindeki toplu seçim kutusu.
- *
- * <h3>Neden `Checkbox` değil</h3>
- * Seçim sütununda etiket sütun başlığıdır ve `Checkbox` bileşeninin ürettiği
- * `<label>` sarmalayıcısı (yan yana kutu + metin yerleşimi) hücreyi bozar.
- * Doğru olan yalın `<input type="checkbox">` + `aria-label` — bu bileşen o
- * deseni resmileştirir ki ekranlar çıplak `<input>` yazmak zorunda kalmasın.
- *
- * <p>Renk `Checkbox` ile aynı kaynaktan: `accent-color` mavi — onay kutusu bir
- * seçimdir, bir dönüşüm değil.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Space`</td><td>seçimi değiştirir</td></tr>
- * </table>
- * Yerel öğe: `Space`, `indeterminate` durumu ve form gönderimine katılma
- * platformdan gelir. Nöbetçi: `components/__tests__/keyboard.test.tsx`.
- */
+/** Tablo hücresindeki toplu seçim kutusu. */
 declare const TableCheckbox_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type" | "aria-label"> & {
 /**
 * Erişilebilir ad — ZORUNLU. Hücrede görünür etiket yok (etiket sütun
@@ -3961,15 +2231,6 @@ testId?: string;
 /**
  * Tablo kaydırma kutusu — "tablo kendi kutusunda kayar, sayfa asla yatay
  * kaymaz" kuralının tek uygulaması.
- *
- * <p>Yatay kaydırma yalnızca BİLEREK kurulur: geniş tablo bu kutunun içinde
- * kayar; `min-width: 0` + `align-self: stretch` kutunun esnek bir kapsayıcıda
- * kendisinin taşmasını engeller. Üç tablonun üç ayrı elle kurulmuş (ya da hiç
- * kurulmamış) kaydırma stratejisi vardı; stratejisi olmayan tabloda monospace
- * değerler 360 px'te sayfanın kendisini yatay kaydırıyordu.
- *
- * <p>Kaydırma çubuğu TEMALI (`custom-scrollbar`): işletim sisteminin açık
- * çubuğu koyu temada tablonun altında parlak bir şerit bırakıyordu.
  */
 export declare const TableScroller: FC<ScrollerProps>;
 
@@ -3979,208 +2240,40 @@ export declare const TABLET_PORTRAIT_BREAKPOINT = 768;
 
 export declare const Tabs: typeof Tabs_2;
 
-/**
- * Sekmeler.
- *
- * <p>ARIA sekme kalıbı tam uygulanır: `role="tablist"`, `aria-selected`,
- * `aria-controls` ve ok tuşlarıyla gezinme. Yalnızca görsel olarak sekme gibi
- * duran düğmeler, klavye kullanıcısı için gezinilemez bir yapı olurdu.
- *
- * <p>Seçili olmayan panel DOM'dan çıkarılır: gizli panellerdeki bağlantılar ve
- * girdiler sekme sırasına girmemeli.
- *
- * <h3>İki kullanım</h3>
- * <ul>
- *   <li><b>Kontrolsüz + panelli</b> — `items[].content` verilir, bileşen
- *       seçimi kendisi tutar.</li>
- *   <li><b>Kontrollü + panelsiz</b> — `activeId` + `onChange` verilir,
- *       `content` verilmez; bileşen yalnızca çubuğu çizer.</li>
- * </ul>
- *
- * <h3>Klavye (APG: tabs, OTOMATİK etkinleştirme)</h3>
- * <table>
- *   <tr><td>`ArrowRight` / `ArrowLeft`</td><td>sonraki / önceki sekme; uçlarda DÖNER</td></tr>
- *   <tr><td>`Tab`</td><td>çubuktan panele çıkar — çubuk TEK durak</td></tr>
- * </table>
- * Ok tuşu odakla birlikte seçimi de taşır (otomatik etkinleştirme). Panel
- * içeriği hazır ve ucuz olduğu sürece APG'nin önerdiği budur; her sekmesi bir
- * istek atan pahalı bir panelde `isManualActivation` verilir — orada otomatik
- * etkinleştirme, kullanıcı beşinci sekmeye giderken dört istek atıyordu.
- * Nöbetçi: `components/__tests__/keyboard.test.tsx`.
- */
+/** Sekmeler. */
 declare const Tabs_2: FC<Props_37>;
 
 export declare const TagInput: typeof TagInput_2;
 
-/**
- * Etiket girdisi — yazılan metni kaldırılabilir çiplere çevirir.
- *
- * <h3>Yerel `<input>` KORUNUR</h3>
- * Yazma, panodan yapıştırma, mobil klavye ve `Tab` sırası tarayıcıdan geliyor.
- * Çipler girdinin İÇİNDE görünüyor ama DOM'da kardeşi: `<input>` çocuk
- * alamıyor ve çipleri içine koymanın tek yolu girdiyi taklit etmekti.
- *
- * <h3>Neden {@link Combobox} değil</h3>
- * `Combobox` BİLİNEN bir listeden seçtiriyor; burada değer serbest — kullanıcı
- * listede olmayan bir şey yazıyor (arama terimi, OEM kodu, e-posta). Seçilecek
- * bir liste varsa `Combobox` doğrusu.
- *
- * <h3>Yinelenen değer sessizce YUTULMAZ</h3>
- * Aynı etiket ikinci kez yazıldığında eklenmiyor ama girdi de temizleniyor;
- * kullanıcı "yazdım, kayboldu" diyordu. Artık var olan çip bir kare
- * vurgulanıyor ve ekran okuyucuya "zaten ekli" duyuruluyor.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Enter` / `,`</td><td>yazılanı etikete çevirir</td></tr>
- *   <tr><td>`Backspace` (girdi BOŞken)</td><td>SON etiketi kaldırır</td></tr>
- *   <tr><td>`Tab`</td><td>girdiden çıkar — yazılan metin de etikete DÖNER</td></tr>
- *   <tr><td>çipin çarpısı</td><td>o etiketi kaldırır</td></tr>
- * </table>
- * `Tab`ta yazılanın etikete dönmesi bilinçli: yarım kalmış bir metin alanı
- * terk edildiğinde kayboluyordu ve kullanıcı bunu ancak gönderdikten sonra
- * fark ediyordu.
- */
+/** Etiket girdisi — yazılan metni kaldırılabilir çiplere çevirir. */
 declare const TagInput_2: ({ values, onChange, label, placeholder, removeLabel, separators, maxTags, isDisabled, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_14) => JSX.Element;
 
 export declare const Textarea: typeof Textarea_2;
 
-/**
- * Çok satırlı metin girdisi.
- *
- * <p>Görünüm {@link Input} ile aynı gövdeden gelir: bir formda tek satırlı ve
- * çok satırlı alanlar yan yana durur, kenarlık ve odak davranışları ayrışırsa
- * form derlenmemiş görünür.
- *
- * <p>Yeniden boyutlandırma yalnızca <strong>dikey</strong>: yatayda büyütmek
- * alanı kapsayıcısının dışına taşırıp yerleşimi bozuyordu.
- *
- * <h3>Otomatik yükseklik neden CSS ile değil</h3>
- * `field-sizing: content` bu işi tek satırda yapıyor ama bugün yalnızca
- * Chromium'da var. Ölçüm yolu her yerde çalışıyor ve tarayıcı desteği
- * geldiğinde tek dosyada değiştirilecek.
- */
+/** Çok satırlı metin girdisi. */
 declare const Textarea_2: ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & {
-/**
-* Alan içeriğiyle birlikte BÜYÜR — kaydırma çubuğu yerine yükseklik.
-*
-* <p>Sabit yükseklikli bir alanda kullanıcı yazdığının tamamını göremiyor:
-* dört satırlık bir kutuya on satır yazan kişi, gönderdiğinde ne yazdığını
-* kontrol etmek için kutunun içinde kaydırmak zorunda kalıyordu. `maxRows`
-* ile tavan konur; ötesinde kaydırma geri döner (sayfa boyunca uzayan bir
-* alan, altındaki gönder düğmesini ekrandan çıkarıyordu).
-*/
+/** Alan içeriğiyle birlikte BÜYÜR — kaydırma çubuğu yerine yükseklik. */
 isAutoSize?: boolean;
 /** Otomatik büyümenin tavanı (satır). */
 maxRows?: number;
-/**
-* Kalan karakter sayacını gösterir. `maxLength` ile birlikte anlamlı.
-*
-* <p>Sayaç `aria-hidden`: aynı bilgi her tuşta duyurulsaydı yazma
-* kesintiye uğrardı. Sınıra YAKLAŞILDIĞINDA (son %10) sayaç uyarı tonuna
-* geçiyor — sınıra çarpıp yazamamak, yaklaştığını görmemekten kötü.
-*/
+/** Kalan karakter sayacını gösterir. `maxLength` ile birlikte anlamlı. */
 hasCounter?: boolean;
 testId?: string;
 } & RefAttributes<HTMLTextAreaElement>>;
 
 export declare const TextLink: typeof TextLink_2;
 
-/**
- * Metin bağlantısı.
- *
- * <h3>Ok bir süs değil</h3>
- * Sondaki ok yalnızca <em>gezinme</em> bağlantılarında kullanılır ("Tümünü gör
- * →"). Bir eylemi tetikleyen bağlantıya ok koymak, kullanıcıya başka bir
- * sayfaya gideceğini söyler ve beklentiyi yanıltır.
- *
- * <p>Ok, üzerine gelindiğinde <strong>ilerler</strong>: hareket, bağlantının
- * götürdüğü yönü fiziksel olarak sezdirir.
- *
- * <h3>Alt çizgi hover'da eklenir, kaldırılmaz</h3>
- * Sürekli altı çizili bağlantılar yoğun bir liste sayfasında görsel gürültü
- * yaratıyordu. Ama alt çizginin <em>hiç</em> olmaması bağlantıyı düz metinden
- * ayırt edilemez kılar; renk tek başına yeterli değil (WCAG 1.4.1). Çözüm:
- * renk her zaman, alt çizgi etkileşimde.
- */
+/** Metin bağlantısı. */
 declare const TextLink_2: ({ href, children, hasArrow, tone, size, className, linkProps, ...rest }: Props_2) => JSX.Element;
 
-declare type ThemeState = {
-    /**
-     * ÇÖZÜLMÜŞ tema — ekranda çizili olan. `preference` `system` iken bu alan
-     * işletim sisteminin o anki tercihini taşır.
-     */
-    scheme: HanuiColorScheme;
-    /**
-     * Kullanıcının SEÇİMİ. Üç durumlu bir tema anahtarı (Açık / Koyu / Sistem)
-     * bunu okur; `scheme` okunsaydı "Sistem" seçiliyken düğme "Koyu"yu işaretli
-     * gösterirdi.
-     */
-    preference: HanuiColorPreference;
-    /** `'system'` verildiğinde AÇIK seçim silinir ve sistem tercihi izlenir. */
-    setScheme: (preference: HanuiColorPreference) => void;
-    /** Açık ↔ koyu. `system` iken ÇÖZÜLMÜŞ değerin tersine geçer. */
-    toggle: () => void;
-    /**
-     * Sunucu çıktısında ve hidrasyondan önceki ilk karede `false`.
-     *
-     * <p>Tema anahtarı bunu bekler: sunucu hangi temanın seçili olduğunu
-     * bilmiyor ve bir tahminle çizilen anahtar, doğru tahmin edilse bile
-     * hidrasyonda uyuşmazlık üretiyordu. Anahtar hazır olana kadar
-     * `aria-hidden` bir yer tutucu çizilir.
-     */
-    isReady: boolean;
-};
-
 export declare const Tile: typeof Tile_2;
 
-/**
- * Karo — ikon madalyonu + etiket.
- *
- * <h3>Neden ikon, neden yuvarlak madalyon</h3>
- * Ana giriş noktaları metin listesi olarak verildiğinde kullanıcı satır satır
- * okuyor. İkon, aranan öğeyi <em>okumadan</em> bulmayı sağlar; madalyon ise
- * ikona sabit bir kutu verir — farklı ikonların doğal genişlikleri karoları
- * düzensiz hizalıyordu.
- *
- * <h3>Karonun tamamı tıklanabilir</h3>
- * Bağlantı yalnızca etiketi değil karonun tümünü kaplar. Küçük bir metin
- * bağlantısını hedeflemek, özellikle dokunmatik ekranda gereksiz bir hassasiyet
- * talebiydi.
- *
- * <h3>`meta` neden sayı değil `ReactNode`</h3>
- * "1.248 ürün" cümlesi hem sayı biçimine hem dile bağlı. Bileşen içinde
- * `toLocaleString` çağırmak, o kararı kütüphanenin varsayımına bağlıyordu.
- */
+/** Karo — ikon madalyonu + etiket. */
 declare const Tile_2: ({ label, icon, href, meta, isActive, linkProps, className, testId }: Props_38) => JSX.Element;
 
 export declare const Timeline: typeof Timeline_2;
 
-/**
- * Zaman çizelgesi — sipariş durumu, işlem geçmişi.
- *
- * <h3>{@link Steps} ile farkı: ileri mi geri mi bakıyor</h3>
- * İkisi de sıralı ve durumlu; ayrım yönlerinde:
- *
- * <ul>
- *   <li>`Steps` İLERİ bakar: kullanıcı bir akışın içinde ve kalan adımları
- *       görüyor. Adım sayısı sabit, adımlara dönülebilir.</li>
- *   <li><b>`Timeline` GERİ bakar:</b> olmuş şeylerin kaydı. Olay sayısı
- *       değişken, hiçbiri tıklanabilir değil ve <strong>başarısız</strong>
- *       diye bir durum var — bir adım "başarısız" olamaz, akış orada durur;
- *       bir olay olabilir ve kayıtta kalır.</li>
- * </ul>
- *
- * <h3>Zaman biçimlendirmesi ÇAĞIRANIN</h3>
- * `time` biçimlendirilmiş bir dize. Kütüphane `Intl` çağırsaydı yerel ayarı
- * ve "3 saat önce" mi "14:32" mi yazılacağını kendisi seçmiş olurdu — ikisi
- * de bağlama bağlı kararlar.
- *
- * <h3>Durum renkle DEĞİL, üç şeyle birden</h3>
- * İşaretin <strong>biçimi</strong> (dolu / halka / tik / çarpı), rengi ve
- * ekran okuyucuya okunan <strong>metni</strong>. Yalnızca renk kullanılsaydı
- * "tamamlandı" ile "başarısız" renk körü bir kullanıcı için aynı daireydi.
- */
+/** Zaman çizelgesi — sipariş durumu, işlem geçmişi. */
 declare const Timeline_2: FC<Props_39>;
 
 export declare type TimelineEvent = {
@@ -4200,13 +2293,6 @@ export declare type TimelineStatus = 'done' | 'current' | 'pending' | 'failed';
 /**
  * BİLDİRİM SÖZLEŞMESİ — süre, ikon ve renk kararları TEK YERDE.
  *
- * <h3>Neden harici bir kütüphaneye sarmalayıcı DEĞİL</h3>
- * Tüketici `react-hot-toast` taşıyordu ve gövdeyi kendi yazmak zorunda
- * kalmıştı: kütüphanenin goober sınıfı bizim modül sınıfımızla AYNI
- * özgüllükteydi ve kazananı kaynak sırası belirliyordu — aynı bildirim
- * geliştirmede ve üretimde İKİ FARKLI RENKTE çıkıyordu. Bir sarmalayıcı bu
- * sorunu çözmez, erteler.
- *
  * @example
  * toast.success('Adres kaydedildi');
  * toast.error('Kart reddedildi', { action: { label: 'Yeniden dene', onClick: retry } });
@@ -4224,25 +2310,7 @@ export declare const toast: {
 
 export declare const ToastHub: typeof ToastHub_2;
 
-/**
- * Bildirim yığını — uygulamada <strong>BİR KEZ</strong> çizilir.
- *
- * <h3>Neden tek yığın</h3>
- * Birden fazla canlı bölge, ekran okuyucuların duyuruları birleştirip sırayla
- * okumasına ya da tamamen atlamasına yol açıyor. Yığın kök yerleşimde bir kez
- * durur; `toast.*` çağrıları React ağacının dışından da çalışır.
- *
- * <h3>Duyuru bölgesi HER ZAMAN DOM'da</h3>
- * Kapsayıcı bildirim yokken de çiziliyor. Sonradan DOM'a eklenen bir canlı
- * bölgenin ilk duyurusu güvenilmez — ekran okuyucu bölgeyi izlemeye
- * başlamadan içerik gelmiş oluyor.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Tab`</td><td>bildirimin eylemine ve kapatma düğmesine ulaşır</td></tr>
- *   <tr><td>odak/hover</td><td>kapanma sayacını DURDURUR</td></tr>
- * </table>
- */
+/** Bildirim yığını — uygulamada <strong>BİR KEZ</strong> çizilir. */
 declare const ToastHub_2: ({ closeLabel, className }: HubProps) => ReactPortal | null;
 
 export declare type ToastOptions = {
@@ -4258,110 +2326,44 @@ export declare type ToastOptions = {
     };
 };
 
-export declare type ToastTone = 'info' | 'success' | 'warning' | 'danger';
-
-export declare const Tooltip: typeof Tooltip_2;
+export declare const ToastPortal: typeof ToastPortal_2;
 
 /**
- * İpucu balonu.
- *
- * <h3>Neden native `title` yetmiyor</h3>
- * Tarayıcının `title` özniteliği <strong>dokunmatikte hiç görünmez</strong>,
- * gecikmesi ayarlanamaz ve biçimlendirilemez. Trafiğin ağırlığı mobil olan
- * bir arayüzde "üzerine gelince açıklama çıkar" demek, kullanıcıların çoğu
- * için açıklamanın hiç olmaması demek.
- *
- * <h3>Balon PORTAL ile gövdede</h3>
- * Önce tetikleyicinin içinde `position: absolute` ile duruyordu ve üç yerde
- * birden bozuluyordu: `overflow: hidden` taşıyan bir kapsayıcının içinde
- * (kart, tablo hücresi, `Panel`) KIRPILIYOR, ekranın kenarında görünüm
- * alanının dışına TAŞIYOR, `transform` taşıyan bir atanın altında yığılma
- * bağlamına HAPSOLUYORDU. Konum artık `usePositioning` ile ölçülüyor;
- * gerekçenin tamamı orada.
- *
- * <h3>Neden yalnızca AÇIKLAMA taşır</h3>
- * Balonda <em>yalnızca</em> yardımcı metin durur — bağlantı, düğme veya
- * okunması zorunlu bir bilgi değil. İçine bir eylem konsaydı ona erişmenin
- * yolu olmazdı: balon `pointer-events: none` ve klavyeyle içine girilemiyor.
- * Eylem taşıyan yüzey `Popover`ın işi; kalıcı olması gereken metin `Field`ın
- * `hint`i.
- *
- * <h3>Dokunmatik: uzun basma</h3>
- * Dokunmatikte `hover` yok — ipucu orada hiç açılmıyordu. Uzun basma balonu
- * açar; ekranın herhangi bir yerine dokunmak kapatır. Bağlam menüsü
- * bastırılır: uzun basmada iOS'ta seçim büyüteci, Android'de kopyala menüsü
- * çıkıyor ve ikisi de balonun üstüne biniyordu.
+ * `ToastHub`ı montajdan SONRA çizen sarmalayıcı.
  *
- * <h3>Kapanma toleransı</h3>
- * İmleç tetikleyiciden çıkar çıkmaz kapatmak, balonun kendisine ulaşmayı
- * imkânsız kılıyordu (metin seçilemiyor). Kapanış {@link CLOSE_DELAY} kadar
- * bekletilir ve bu sürede balona giren imleç onu açık tutar.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`Tab`</td><td>tetikleyiciye gelince GECİKMESİZ açılır</td></tr>
- *   <tr><td>`Escape`</td><td>kapatır; odak tetikleyicide kalır</td></tr>
- * </table>
- * Gecikme fare için var; Tab ile gelen kullanıcı zaten bilinçli olarak orada
- * duruyor.
+ * ⚠ SUNUCUDA ÇİZİLMEMESİ ŞART. `ToastHub` portal kullanıyor ve `document`
+ * olmadan çalışamaz; sunucu tarafında çizilen bir ağaçta doğrudan kullanmak
+ * hidrasyon uyuşmazlığı üretir. Next.js kullanan iki uygulamada da aynı
+ * sarmalayıcı BİREBİR AYNI dosya olarak yazılmıştı — çözüm uygulamaya değil
+ * bileşene ait.
  */
+declare const ToastPortal_2: FC;
+
+export declare type ToastTone = 'info' | 'success' | 'warning' | 'danger';
+
+export declare const Tooltip: typeof Tooltip_2;
+
+/** İpucu balonu. */
 declare const Tooltip_2: ({ content, children, side, position, openDelay, className }: Props_3) => JSX.Element;
 
-/**
- * Ölçü basamakları.
- *
- * <p>`MEDIUM` ve `LARGE` dokunma hedefi kuralına uyar (WCAG 2.5.8, ≥44 px).
- * `SMALL` yoğun şeritler içindir ve orada görsel kutu küçülür ama tıklanabilir
- * alan `tap-target` ile korunur.
- */
+/** Ölçü basamakları. */
 export declare enum UISize {
     SMALL = "SMALL",
     MEDIUM = "MEDIUM",
     LARGE = "LARGE"
 }
 
-/**
- * Düğme ve eylem varyantları.
- *
- * <p>Sıra bir <strong>vurgu hiyerarşisi</strong>dir: bir ekranda tek bir
- * `PRIMARY` bulunur. İki dolu düğme yan yana durduğunda hiçbiri öne çıkmaz ve
- * kullanıcı hangisinin beklenen eylem olduğunu bilemez.
- *
- * <h3>Doygun dolgu = tıklanabilir</h3>
- * Bu kuralın karşılığı: durum etiketleri (rozet, uyarı) her zaman tint
- * zeminlidir, eylemler her zaman dolgulu veya çerçevelidir. İkisi karışırsa
- * kullanıcı bir durum etiketine tıklamayı dener.
- */
+/** Düğme ve eylem varyantları. */
 export declare enum UIVariant {
-    /**
-     * Ekranın tek beklenen eylemi: <strong>nötr grafit</strong> dolgu.
-     *
-     * <p>`CART` DEĞİL. Doygun turuncu tek bir dönüşüm noktasına ayrıldı; her
-     * dolu düğmeyi o renge boyamak tekilliği yok eder ve kullanıcı hangi
-     * turuncunun dönüşüm olduğunu bilemez.
-     */
+    /** Ekranın tek beklenen eylemi: <strong>nötr grafit</strong> dolgu. */
     PRIMARY = "PRIMARY",
-    /**
-     * <strong>Dönüşüm eylemi — ve yalnızca o.</strong>
-     *
-     * <p>Ekranda görünen tek doygun turuncu. Favori, karşılaştır, paylaş,
-     * filtrele hepsi nötr veya mavidir. Bir kampanya bandında bu ton
-     * kullanılırsa o ekranda dönüşüm düğmesi `PRIMARY`'ye çevrilir — ikisi aynı
-     * anda olmaz.
-     *
-     * <p>Adı domain'den geliyor (kaynak sistemde "sepete ekle") ve
-     * kasıtlı korundu: bir ekranda kaç tane olabileceğini adın kendisi
-     * söylüyor. `ACCENT` deseydi hiyerarşi bilgisi kaybolurdu.
-     */
+    /** <strong>Dönüşüm eylemi — ve yalnızca o.</strong> */
     CART = "CART",
     /** Nötr ikincil eylem: gri kenarlık, koyu metin ("Vazgeç"). */
     SECONDARY = "SECONDARY",
     /**
      * Mavi çerçeveli eylem — teşvik edilen ama birincil olmayan gezinme
      * ("Tümünü gör").
-     *
-     * <p>Çerçeveli, dolgulu değil: mavi gezinme ve keşif rengidir; dolu mavi
-     * düğme onu bir dönüşüm noktası gibi gösterip `CART` ile yarışıyordu.
      */
     OUTLINE = "OUTLINE",
     /** Vurgu bandı içindeki eylem: bandın kendi yüzey merdivenini kullanır. */
@@ -4391,71 +2393,18 @@ export declare type UploadFile = {
  */
 export declare const useAnnounce: () => ((message: string, politeness?: AnnouncePoliteness) => void);
 
-/**
- * Sağlayıcı ZORUNLU DEĞİL.
- *
- * <p>Sağlayıcısız kullanımda bağlantılar ham `<a>` olur ve tema
- * varsayılanlarda kalır — yani paket `import` edilip hiçbir kurulum
- * yapılmadan çalışır. Sağlayıcıyı zorunlu kılmak, tek bir `Badge` kullanmak
- * isteyen bir tüketiciyi de kök yerleşimi değiştirmeye zorluyordu.
- */
+/** Sağlayıcı ZORUNLU DEĞİL. */
 export declare const useHanui: () => HanuiContextValue;
 
 /**
  * Açık/koyu seçimini okur ve değiştirir.
  *
- * <h3>KALICILIK BU KANCANIN İŞİ DEĞİL</h3>
- * Seçimi nereye yazacağı tüketicinin kararı: `localStorage`, bir çerez (SSR'da
- * okunabilmesi için), kullanıcı profili. Kütüphane `localStorage`a yazsaydı
- * sunucu tarafı onu okuyamayacağı için ilk boyama yine yanlış temada
- * olurdu — ve tüketici kendi çerezini kullanmak istediğinde iki kaynak
- * çatışırdı.
- *
- * <h3>Geçiş tek karede kapatılır</h3>
- * Şema değişirken `<html>` bir kare boyunca `hanui-theme-switching` sınıfını
- * taşır. Sınıfsız hâlde her yüzey aynı anda ama FARKLI sürelerde animasyon
- * yapıyordu (kart gölgesi 140 ms, sayfa zemini 200 ms) ve geçiş dalgalı
- * görünüyordu. Ani geçiş, dalgalı geçişten iyi.
- *
  * @example
  * const { scheme, toggle, isReady } = useHanuiTheme();
- *
- * useEffect(() => {
- *   if (isReady) localStorage.setItem('theme', scheme);
- * }, [scheme, isReady]);
  */
-export declare const useHanuiTheme: () => ThemeState;
+export declare const useHanuiTheme: () => HanuiThemeState;
 
-/**
- * LISTBOX KLAVYE GEZİNMESİ — `Select` ve `Combobox`ın ortak modeli.
- *
- * <h3>Neden bir kanca</h3>
- * İki bileşen aynı klavye modelini <strong>kopya kod</strong> olarak
- * taşıyordu: `ArrowDown`/`ArrowUp` uçlarda dönme, `Home`/`End`, `Enter` ile
- * seçme, `Escape` ile kapatma, `Tab` ile kapatıp gezinmeye devam etme ve
- * etkin seçeneği görünür alanda tutma. Altı davranış, iki yerde. Kopya kod
- * ayrışmaya açık ve ayrışma sessiz: bir bileşende `Home` çalışıp diğerinde
- * çalışmadığında hiçbir test kırılmıyordu — ikisinin de kendi testi vardı ve
- * ikisi de kendi davranışını doğruluyordu.
- *
- * <p>Kanca yalnızca <strong>gezinmeyi</strong> taşıyor. Açılma kararı (panel
- * mi alt sayfa mı), filtreleme ve seçim sözleşmesi (`value`/`onChange`) hâlâ
- * bileşenlerin: ikisi orada gerçekten farklı ve tek bir kancaya toplamak
- * `Select`e hiç kullanmayacağı arama koduna taşıtırdı.
- *
- * <h3>Klavye</h3>
- * <table>
- *   <tr><td>`ArrowDown` / `ArrowUp`</td><td>etkin seçenek; uçlarda DÖNER</td></tr>
- *   <tr><td>`Home` / `End`</td><td>ilk / son</td></tr>
- *   <tr><td>`Enter` / `Space`</td><td>etkin seçeneği seçer</td></tr>
- *   <tr><td>`Escape`</td><td>kapatır</td></tr>
- *   <tr><td>`Tab`</td><td>kapatır, gezinme SÜRER (`preventDefault` yok)</td></tr>
- * </table>
- *
- * <p>`Space` yalnızca `hasSpaceSelect` ile: `Combobox`ın arama kutusunda boşluk
- * bir KARAKTER ve onu seçime çevirmek "fren balatası" yazmayı imkânsız
- * kılıyordu.
- */
+/** LISTBOX KLAVYE GEZİNMESİ — `Select` ve `Combobox`ın ortak modeli. */
 export declare const useListboxNavigation: <T extends HTMLElement = HTMLElement>({ count, isOpen, initialIndex, onSelect, onClose }: ListboxNavigationOptions, { hasSpaceSelect }?: {
     hasSpaceSelect?: boolean | undefined;
 }) => ListboxNavigation<T>;
@@ -4463,46 +2412,6 @@ export declare const useListboxNavigation: <T extends HTMLElement = HTMLElement>
 /**
  * ÇARPIŞMAYA DUYARLI KONUMLANDIRMA — `Tooltip`, `Popover`, `Menu` ve açılır
  * listelerin ortak temeli.
- *
- * <h3>Neden var: `position: absolute` yetmiyordu</h3>
- * `Tooltip` balonu tetikleyicinin içinde, `position: absolute` ile duruyordu.
- * Üç somut sonucu vardı:
- *
- * <ul>
- *   <li><b>Kırpılma.</b> `overflow: hidden` taşıyan her kapsayıcı (kart,
- *       tablo kaydırma kutusu, `Panel`) balonu kesiyordu. Bir tablo hücresinde
- *       ipucu görünmüyordu — hiç.</li>
- *   <li><b>Taşma.</b> Ekranın sağ kenarındaki bir tetikleyicinin balonu
- *       görünüm alanının dışına çıkıyor, yatay kaydırma açıyordu.</li>
- *   <li><b>Yığılma bağlamı.</b> `transform` taşıyan bir ata (`Card` hover
- *       animasyonu) yeni bir yığılma bağlamı açıyor ve `z-index` orada
- *       hapsoluyordu; balon kendi kartının altında kalıyordu.</li>
- * </ul>
- *
- * <p>Çözüm portal + `position: fixed`: yüzey gövdeye taşınır, koordinat
- * görünüm alanına göre hesaplanır. Kırpılacak bir kapsayıcı ve yarışılacak bir
- * yığılma bağlamı kalmaz.
- *
- * <h3>Neden yeni bir bağımlılık YOK</h3>
- * `floating-ui` bu işi yapıyor ve iyi yapıyor; ama paketin tek çalışma zamanı
- * bağımlılığının ikon seti olması bilinçli bir karar (bkz. README). Burada
- * ihtiyaç duyulan şey o kütüphanenin küçük bir alt kümesi: bir kenar, bir
- * hizalama ve karşıt kenara düşme. Ok konumlandırma, otomatik yerleşim
- * (`autoPlacement`), sanal öğe ve middleware zinciri gerekmiyor — ve
- * gerektiğinde eklenecek yer burası.
- *
- * <h3>CSS Anchor Positioning neden kullanılmıyor</h3>
- * Denendi ve BUGÜN kullanılamıyor: `anchor-name` / `position-anchor` yalnızca
- * Chromium'da var (Safari ve Firefox'ta bayrak arkasında bile değil). İki
- * kod yolu tutmak — biri modern tarayıcıda, biri yedekte — konumlandırmayı iki
- * kez yazmak ve ikisinin ayrışmasını beklemek demek. Ölçüm tabanlı yol her
- * yerde çalışıyor; tarayıcı desteği geldiğinde geçiş TEK dosyada.
- *
- * <h3>Ölçüm ne zaman yenileniyor</h3>
- * Açılışta, pencere yeniden boyutlandığında ve <em>herhangi bir atanın</em>
- * kaydırılmasında. Sonuncusu için `capture: true` ile belge düzeyinde tek bir
- * dinleyici: kaydırma olayı baloncuklanmıyor ve her ata için ayrı dinleyici
- * kurmak, derin bir ağaçta onlarca dinleyici demekti.
  */
 export declare const usePositioning: (anchorRef: {
     current: HTMLElement | null;
@@ -4515,61 +2424,14 @@ export declare const useScrollLock: (isLocked?: boolean) => void;
 /**
  * Alt sayfayi <strong>gorunen</strong> alana yaslar.
  *
- * <h3>Neden `dvh` ve `env()` yetmiyor</h3>
- * `dvh` tarayici cubuklarini hesaba katar ama <em>klavyeyi katmaz</em>;
- * `env(safe-area-inset-bottom)` ise cihazin centik/ana ekran cubugu payidir, o
- * da klavyeden habersiz. iOS'ta klavye acildiginda yerlesim gorunum alani hic
- * degismez: panel oldugu yerde durur, klavye uzerine biner ve alt yarisi —
- * arama kutusuyla birlikte — erisilemez hale gelir.
- *
- * <h3>Android'de ne oluyor</h3>
- * Tuketici `interactiveWidget: 'resizes-content'` verdiginde orada klavye
- * yerlesim alanini da kuculttugu icin fark sifir cikar ve bu kanca hicbir sey
- * degistirmez. Duzeltme iOS icindir, ama olcum platformdan bagimsiz dogru.
- *
- * <h3>Degiskenler `<html>` uzerinde</h3>
- * Panelin kendisine yazilamaz: `::backdrop` ve `<dialog>` ust katmandadir,
- * ayrica ayni degeri iki farkli panel paylasiyor. Kok ogeye yazmak tek kaynak
- * birakir.
- *
  * @param isActive Panel acik mi. Yalnizca acikken olculur: kendisi yalnizca
- *   acikken cizilen bir panel varsayilani kullanir, ama sayfa boyunca DOM'da
- *   duran bir panel bayraksiz cagirdiginda her kullanicida iki gorunum alani
- *   dinleyicisi bos yere acik kaliyordu.
+ * acikken cizilen bir panel varsayilani kullanir, ama sayfa boyunca DOM'da
+ * duran bir panel bayraksiz cagirdiginda her kullanicida iki gorunum alani
+ * dinleyicisi bos yere acik kaliyordu.
  */
 export declare const useSheetViewport: (isActive?: boolean) => void;
 
-/**
- * SANALLAŞTIRMA — yalnızca görünen satırları çiz.
- *
- * <h3>Ölçülen sorun</h3>
- * 1121 markalı bir `Combobox` listesinde DOM 1121 satır taşıyordu. Panel
- * açılışı mobilde gözle görülür şekilde donuyor, her tuş vuruşunda liste
- * yeniden çiziliyordu. Ekran okuyucu tarafında da bedeli var: 1121 öğelik bir
- * `listbox`ta gezinmek pratikte imkânsız.
- *
- * <h3>Neden kütüphane içinde</h3>
- * `react-window` / `@tanstack/virtual` bu işi yapıyor ve iyi yapıyor; ama
- * paketin tek çalışma zamanı bağımlılığının ikon seti olması bilinçli bir
- * karar. Burada gereken şey o kütüphanelerin küçük bir alt kümesi: SABİT
- * yükseklikli satırlar, tek eksen, yatay yok, değişken yükseklik yok.
- *
- * <h3>SABİT satır yüksekliği — ve bu bir kısıt</h3>
- * Değişken yükseklikli sanallaştırma her satırın ölçülmesini ve bir konum
- * haritası tutulmasını gerektiriyor. Açılır liste satırları zaten sabit
- * yükseklikte (`min-height` + tek satır metin); ikincil satır taşıyan
- * seçeneklerde ölçü `rowHeight` ile verilir.
- *
- * <h3>`overscan` neden var</h3>
- * Yalnızca görünen satırlar çizilseydi hızlı kaydırmada alt kenarda bir kare
- * boyunca boşluk görünüyordu — tarayıcı kaydırma olayını boyamadan sonra
- * veriyor. Görünür alanın üstüne ve altına birkaç satır fazladan çizilir.
- *
- * <h3>Klavye gezinmesiyle ilişkisi</h3>
- * Etkin seçeneği görünür tutan `scrollIntoView`, o seçenek ÇİZİLMEMİŞSE
- * çalışmaz. `scrollToIndex` bu yüzden var: klavyeyle listenin dibine giden
- * kullanıcı için konum önce hesaplanır, satır sonra çizilir.
- */
+/** SANALLAŞTIRMA — yalnızca görünen satırları çiz. */
 export declare const useVirtualList: (count: number, { rowHeight, overscan, isEnabled }?: {
     rowHeight?: number | undefined;
     overscan?: number | undefined;