@ahmetilhn/hanui 4.0.0 → 5.3.0

package/build/index.d.ts

@@ -26,8 +26,11 @@ export declare const ABOVE_TABLET_MEDIA_QUERY = "(min-width: 1025px)";
 
 export declare const Accordion: typeof Accordion_2;
 
-/** Akordeon — katlanabilir bölümler. */
-declare const Accordion_2: FC<Props_37>;
+/**
+ * Akordeon — katlanabilir bölümler. Her bölüm bir `Disclosure`: yerel `<details>` mantığı (kontrollü
+ * kipte DOM eşitlemesi, `onToggle`, pasif başlık) TEK yerde yaşar.
+ */
+declare const Accordion_2: FC<Props_40>;
 
 export declare type AccordionItem = {
     id: string;
@@ -42,33 +45,38 @@ export declare type AccordionItem = {
 export declare const Alert: typeof Alert_2;
 
 /** Bilgi / uyarı kutusu. */
-declare const Alert_2: FC<Props_17>;
+declare const Alert_2: FC<Props_18>;
 
 export declare type AlertTone = 'info' | 'success' | 'warning' | 'danger';
 
 /** Duyurunun aciliyeti. */
 export declare type AnnouncePoliteness = 'polite' | 'assertive';
 
-/**
- * Ezmeleri belgeye yazar. Aynı `<style>` etiketi tekrar kullanılır: her
- * çağrıda yeni bir etiket eklemek, birbirini ezen onlarca blok bırakıyordu.
- */
+/** Ezmeleri belgeye yazar. */
 export declare const applyThemeConfig: (config: HanuiThemeConfig | undefined) => void;
 
 export declare const Avatar: typeof Avatar_2;
 
 /** Avatar — kullanıcı madalyonu. */
-declare const Avatar_2: FC<Props_18>;
+declare const Avatar_2: FC<Props_19>;
+
+declare type AvatarShape = 'circle' | 'rounded';
+
+/**
+ * `auto`: baş harf madalyonu addan SABİT bir kovaya boyanır. `brand`: marka madalyonu — çam zemin,
+ * mint işaret, iki temada aynı (logo kuralı; asistanın avatarı, boş sohbetin karosu).
+ */
+declare type AvatarTone = 'auto' | 'brand';
 
 export declare const Badge: typeof Badge_2;
 
 /** Rozet — durum ve sınıflandırma etiketi. */
-declare const Badge_2: FC<Props_19>;
+declare const Badge_2: FC<Props_20>;
 
 export declare type BadgeTone = 'neutral' | 'success' | 'danger' | 'warning' | 'info'
-/** Birincil sınıflandırma tinti (mavi-lacivert aile). */
+/** Birincil sınıflandırma tinti (yeşil aile — Hanparça "Orijinal"). */
 | 'oem'
-/** İkincil sınıflandırma tinti (mor aile). */
+/** İkincil sınıflandırma tinti (menekşe aile — Hanparça "Muadil"). */
 | 'alt'
 /** İndirim / olumlu değişim yüzdesi. Tutarın kendisi nötr kalır. */
 | 'sale'
@@ -102,13 +110,9 @@ declare type BaseProps_2 = {
 
 declare type BaseProps_3 = {
     isOpen: boolean;
-    /** Vazgeçme ve perde/Escape kapanışı. Başarı kapanışını bileşen kendisi yapar. */
+    /** Vazgeçme ve perde/Escape kapanışı. */
     onClose: () => void;
-    /**
-     * Girilen değerle çalışır (değer kırpılmış gönderilir). Reddederse pencere
-     * AÇIK kalır ve metin korunur; hata bildirimi çağıranın işi — bildirimi
-     * gösterip hatayı yeniden fırlatın ya da hiç yakalamayın.
-     */
+    /** Girilen değerle çalışır (değer kırpılmış gönderilir). */
     onSubmit: (value: string) => void | Promise<void>;
     title: string;
     /** Girdi alanının etiketi. */
@@ -117,18 +121,14 @@ declare type BaseProps_3 = {
     submitLabel?: string;
     /** Verilmezse `labels.cancel`. */
     cancelLabel?: string;
-    /** Kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    /** Kapatma düğmesinin erişilebilir adı. */
     closeLabel?: string;
     /** Başlığın altındaki bir cümlelik bağlam. */
     description?: ReactNode;
     hint?: string;
     placeholder?: string;
     defaultValue?: string;
-    /**
-     * `text` tek satır, `multiline` gerekçe gibi uzun metin, `number` adet/fark
-     * gibi sayılar. Değer her durumda dize döner; ayrıştırmak çağıranın işi
-     * (bir stok farkı `-5` gibi işaretli olabiliyor).
-     */
+    /** `text` tek satır, `multiline` gerekçe gibi uzun metin, `number` adet/fark gibi sayılar. */
     inputMode?: 'text' | 'multiline' | 'number';
     maxLength?: number;
     rows?: number;
@@ -137,32 +137,29 @@ declare type BaseProps_3 = {
 declare type BaseProps_4 = {
     page: number;
     totalPages: number;
-    /** Gezinme bölgesinin erişilebilir adı. Verilmezse `labels.pagination.label`. */
+    /** Gezinme bölgesinin erişilebilir adı. */
     label?: string;
     /** Verilmezse `labels.pagination.previous`. */
     previousLabel?: string;
     /** Verilmezse `labels.pagination.next`. */
     nextLabel?: string;
-    /**
-     * Sayfa değiştiğinde ekran okuyucuya duyurulacak metin
-     * ("3. sayfa · 1.248 sonuç").
-     */
+    /** Sayfa değiştiğinde ekran okuyucuya duyurulacak metin ("3. sayfa · 1.248 sonuç"). */
     formatAnnouncement?: (page: number, totalPages: number) => string;
     /**
-     * Sayfa değiştiren bir tıklamadan sonra kaydırma. `'top'` verilirse pencere
-     * en üste alınır — çağıran tarafta kaydırma kodu yazılmaz.
+     * Sayfa değiştiren bir tıklamadan sonra kaydırma. `'top'` verilirse pencere en üste alınır —
+     * çağıran tarafta kaydırma kodu yazılmaz.
      */
     scrollTo?: 'top';
     className?: string;
     testId?: string;
 };
 
-export declare const BottomSheet: MemoExoticComponent<({ title, closeLabel, onClose, children, toolbar, footer, closeAbove, className, testId, }: Props_42) => ReactPortal | null>;
+export declare const BottomSheet: MemoExoticComponent<({ title, closeLabel, onClose, children, toolbar, footer, closeAbove, className, testId, }: Props_46) => ReactPortal | null>;
 
 export declare const Breadcrumb: typeof Breadcrumb_2;
 
 /** Kırıntı yolu. */
-declare const Breadcrumb_2: FC<Props_20>;
+declare const Breadcrumb_2: FC<Props_21>;
 
 /** Yapılandırmayı CSS metnine çevirir. */
 export declare const buildThemeCss: (config: HanuiThemeConfig) => string;
@@ -171,15 +168,12 @@ export declare const Button: typeof Button_2;
 
 /**
  * Düğme.
- *
- * @example
- * <Button variant={UIVariant.PRIMARY} isLoading={isSaving} onClick={save}>
- * Kaydet
- * </Button>
+ * @example <Button variant={UIVariant.PRIMARY} isLoading={isSaving} onClick={save}> Kaydet…
  */
 declare const Button_2: ForwardRefExoticComponent<Partial<{
 variant: UIVariant;
 size: UISize;
+shape: ButtonShape;
 isLoading: boolean;
 isFullWidth: boolean;
 startIcon: ReactNode;
@@ -191,10 +185,7 @@ testId: string;
 }> & ButtonHTMLAttributes<HTMLButtonElement> & {
 /** Verilirse düğme bir bağlantı olarak çizilir. */
 href?: string;
-/**
-* Uygulama dışına çıkan bağlantı: yeni sekmede açılır ve yönlendirici
-* devreye girmez.
-*/
+/** Uygulama dışına çıkan bağlantı: yeni sekmede açılır ve yönlendirici devreye girmez. */
 isExternal?: boolean;
 /** Yönlendiriciye geçirilecek ek props (`{ scroll: false }`, `{ replace: true }`). */
 linkProps?: HanuiLinkExtraProps;
@@ -207,27 +198,21 @@ declare type ButtonProps = BaseProps_4 & {
     linkProps?: never;
 };
 
+/** Köşe biçimi. `pill` üst bant ve araç çubuğundaki hafif eylemler için; ölçü değişmez. */
+declare type ButtonShape = 'rounded' | 'pill';
+
 export declare const Card: typeof Card_2;
 
 /**
  * Kart — medya + gövde + eylem şeridi.
- *
- * @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>
- * </Card>
+ * @example <Card as="article" isInteractive> <CardMedia href="/urun/x" ratio={1}>…
  */
 declare const Card_2: FC<CardProps>;
 
 /** Kartın metin gövdesi: başlık, açıklama, üstyazı. */
 export declare const CardBody: FC<CardSectionProps>;
 
-/** Eylem şeridi — tutar, düğmeler. Kartın dibine yapışır. */
+/** Eylem şeridi — tutar, düğmeler. */
 export declare const CardFooter: FC<CardSectionProps>;
 
 /** Kartın görsel alanı. */
@@ -238,20 +223,15 @@ export declare type CardMediaFit = 'cover' | 'contain' | 'inset';
 
 declare type CardMediaProps = {
     children: ReactNode;
-    /** Genişlik / yükseklik oranı. Sabit oran yükleme sırasında kaymayı önler. */
+    /** Genişlik / yükseklik oranı. */
     ratio?: number;
     /** Medya alanı tıklanabilirse: görsel bağlantının içine alınır. */
     href?: string;
     /** Yönlendiriciye geçirilecek ek props. */
     linkProps?: HanuiLinkExtraProps;
-    /** Görsel çerçeveyi nasıl doldurur — bkz. {@link CardMediaFit}. */
+    /** Görsel çerçeveyi nasıl doldurur — bkz. */
     fit?: CardMediaFit;
-    /**
-     * @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; `CLAUDE.md` → Göç.
-     */
+    /** @deprecated `fit` kullanın: `isContained` → `fit="contain"`, `isContained={false}` →… */
     isContained?: boolean;
     className?: string;
 };
@@ -283,7 +263,7 @@ declare type CardSectionProps = {
 export declare const Carousel: typeof Carousel_2;
 
 /** Kaydırılabilir şerit (carousel). */
-declare const Carousel_2: FC<Props_21>;
+declare const Carousel_2: FC<Props_22>;
 
 export declare const Checkbox: typeof Checkbox_2;
 
@@ -299,7 +279,7 @@ export declare const Chip: typeof Chip_2;
 
 /** Ç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. */
+/** Görünen metin. */
 children?: ReactNode;
 /** Metnin solundaki ikon. */
 icon?: ReactNode;
@@ -309,20 +289,13 @@ endIcon?: ReactNode;
 count?: number;
 isSelected?: boolean;
 size?: ChipSize;
-/**
-* Erişilebilir ad. Görünür metin yoksa <strong>zorunlu</strong>: yalnız ikon
-* taşıyan bir çip ekran okuyucuda "düğme" diye okunur.
-*/
+/** Erişilebilir ad. */
 label?: string;
 /** Verilirse çip bir bağlantı olarak çizilir. */
 href?: string;
 /** Yönlendiriciye geçirilecek ek props. */
 linkProps?: HanuiLinkExtraProps;
-/**
-* Grup içindeki ARIA rolü. Tek seçimli gruplarda `radio`, çok seçimlide
-* verilmez — {@link ChipGroup} bunu kendisi ayarlar; elle kullanımda
-* `aria-pressed` üretilir.
-*/
+/** Grup içindeki ARIA rolü. */
 role?: "radio";
 testId?: string;
 } & RefAttributes<HTMLButtonElement>>;
@@ -330,7 +303,7 @@ testId?: string;
 export declare const ChipGroup: typeof ChipGroup_2;
 
 /** Ç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;
+declare const ChipGroup_2: <T extends string>({ options, label, size, isScrollable, className, ...selection }: Props_7<T>) => JSX.Element;
 
 export declare type ChipOption<T extends string = string> = {
     value: T;
@@ -346,11 +319,16 @@ declare type CircleProps = {
     /** Tamamlanan miktar. `undefined` → BELİRSİZ; çember döner. */
     value?: number;
     max?: number;
-    /** Erişilebilir ad. ZORUNLU. */
+    /** Erişilebilir ad. */
     label: string;
     valueText?: string;
     /** Yüzdeyi çemberin ortasına yazar. */
     isValueVisible?: boolean;
+    /**
+     * ⚠ `brand` 5.0'dan beri MÜREKKEP çizer (`selected` — ilerleme bir seçim göstergesi), yeşil
+     * DEĞİL: yeşil yalnızca eylem, bağlantı ve odakta. Ad 4.x'ten kaldı; değiştirmek her çağrıyı
+     * kırardı ve kazancı yalnızca isim olurdu.
+     */
     tone?: 'brand' | 'success' | 'warning' | 'danger';
     /** Dış çap (px). */
     size?: number;
@@ -361,17 +339,13 @@ declare type CircleProps = {
 export declare const CodeBadge: typeof CodeBadge_2;
 
 /**
- * Teknik kod rozeti — monospace kod, marka zeminli çerçeve.
- *
- * `CopyField`ten farkı ÇERÇEVEDİR: CopyField satır içi çıplak değer, bu
- * bileşen sayfanın kahramanı olan kod (arıza kodu başlığı gibi). Pano
- * mantığı ikisinde de `useCopyFeedback` — ayrışamazlar. Etiketler de
- * `labels.copyField` sözlüğünü paylaşır: aynı eylem için ikinci bir sözlük
- * anahtarı, iki ayrı çeviri kaynağı olurdu.
+ * Teknik kod rozeti — monospace kod, MÜREKKEP zemin (iki temada aynı).
+ * Etkileşimli kipte (`onClick` / `href`) kod bir düğme ya da bağlantıdır; kopyalama düğmesi onun
+ * KARDEŞİ kalır (iç içe düğme geçersiz HTML).
  */
-declare const CodeBadge_2: FC<Props_22>;
+declare const CodeBadge_2: FC<Props_23>;
 
-export declare type CodeBadgeSize = 'sm' | 'md' | 'lg';
+export declare type CodeBadgeSize = 'xs' | 'sm' | 'md' | 'lg';
 
 export declare const Combobox: typeof Combobox_2;
 
@@ -408,9 +382,8 @@ declare type ComboboxProps<T extends string> = {
     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.
+     * Verilirse arama sunucuda yapılır: bileşen listeyi kendisi filtrelemez, yazılanı 300 ms bekleyip
+     * buraya bildirir.
      */
     onSearch?: (query: string) => void;
     isLoading?: boolean;
@@ -422,7 +395,7 @@ declare type ComboboxProps<T extends string> = {
     /** Tetikleyicinin solundaki ikon. */
     icon?: ReactNode;
     id?: string;
-    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. Bkz. `Select.required`. */
+    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. */
     required?: boolean;
     'aria-describedby'?: string;
     'aria-invalid'?: boolean;
@@ -435,10 +408,10 @@ export declare type CommandItem = {
     label: string;
     /** Ayırt edici ikincil satır — bir komutun nereye götürdüğü. */
     description?: string;
-    /** Gruplama başlığı ("Gezinme", "Eylemler"). Aynı grup ardışık çizilir. */
+    /** Gruplama başlığı ("Gezinme", "Eylemler"). */
     group?: string;
     icon?: ReactNode;
-    /** Kısayol ipucu ("⌘K"). Yalnızca GÖSTERİLİR; tuşu çağıran bağlar. */
+    /** Kısayol ipucu ("⌘K"). */
     shortcut?: string;
     onSelect: () => void;
 };
@@ -446,7 +419,7 @@ export declare type CommandItem = {
 export declare const CommandPalette: typeof CommandPalette_2;
 
 /** Komut paleti — klavyeyle her şeye ulaşma. */
-declare const CommandPalette_2: ({ isOpen, onClose, items, label, searchPlaceholder, emptyMessage, className, testId, }: Props_44) => JSX.Element;
+declare const CommandPalette_2: ({ isOpen, onClose, items, label, searchPlaceholder, emptyMessage, hotkey, onOpen, className, testId, }: Props_48) => JSX.Element;
 
 /** Her bileşenin kabul ettiği ortak kanca noktaları. */
 export declare type CommonElementProps = Partial<{
@@ -455,18 +428,7 @@ export declare type CommonElementProps = Partial<{
     testId: string;
 }>;
 
-/**
- * YOĞUN (compact) KİP — `<html data-hanui-density="compact">`.
- *
- * <p>⚠ <strong>17 SABİT DEĞER İKİ ÇARPANA İNDİ.</strong> Eski kip ölçeğin her
- * kademesini elle eziyordu ve o değerler (11/12/13/15/16/18/21/25/31/39)
- * akışkan ölçeğin mobil tabanlarıyla **neredeyse birebir aynıydı**. Sonuç:
- * yoğun kipi açan panel bir telefonda küçülmeyi İKİ KEZ yiyor, `2xs` 10px'in
- * altına düşüyordu. Ezme yerine çarpma, ikisini yapısal olarak uzlaştırıyor.
- *
- * <p>İkinci kazanç: kip artık ölçeğin ÜST ucunu da doğru taşıyor. Eski liste
- * elle yazıldığı için bir kademe eklendiğinde güncellenmesi unutulabilirdi.
- */
+/** YOĞUN (compact) KİP — `<html data-hanui-density="compact">`. */
 export declare const COMPACT_DENSITY: {
     readonly 'type-scale': "0.93";
     readonly 'space-scale': "0.88";
@@ -476,21 +438,16 @@ export declare const ConfirmDialog: typeof ConfirmDialog_2;
 
 /**
  * Onay penceresi.
- *
- * @example
- * const [target, setTarget] = useState<Address | null>(null);
+ * @example const [target, setTarget] = useState<Address | null>(null);
  */
-declare const ConfirmDialog_2: FC<Props_45>;
+declare const ConfirmDialog_2: FC<Props_49>;
 
 export declare type ConfirmKind = 'destructive' | 'warning' | 'neutral';
 
 export declare const CopyField: typeof CopyField_2;
 
-/**
- * Kopyalanabilir teknik değer — <strong>tek dokunuşla panoya</strong>.
- * Pano mantığı `useCopyFeedback`te, `CodeBadge` ile ortak.
- */
-declare const CopyField_2: FC<Props_23>;
+/** Kopyalanabilir teknik değer — tek dokunuşla panoya. */
+declare const CopyField_2: FC<Props_26>;
 
 export declare type Crumb = {
     label: string;
@@ -504,24 +461,20 @@ 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. */
-declare const DataTable_2: FC<Props_49>;
+declare const DataTable_2: FC<Props_53>;
 
 export declare type DataTableColumn = {
     /** Sütun kimliği (React key). */
     key: string;
-    /** Başlık hücresinin içeriği. Toplu seçim kutusu gibi öğeler de girebilir. */
+    /** Başlık hücresinin içeriği. */
     label?: ReactNode;
-    /**
-     * 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.
-     */
+    /** Görsel başlığı olmayan sütunun erişilebilir adı (eylem sütunu gibi). */
     srLabel?: string;
     /** Sıralanabilir sütunun yönü (`aria-sort`). */
     ariaSort?: 'ascending' | 'descending';
     /**
-     * Sütun sıralanabilir. `DataTable.onSort` ile birlikte anlamlı; ikisinden
-     * biri eksikse başlık düz metin kalır — tıklanabilir görünüp hiçbir şey
-     * yapmayan bir başlık, kullanıcıya var olmayan bir yetenek vaat ediyordu.
+     * Sütun sıralanabilir. `DataTable.onSort` ile birlikte anlamlı; ikisinden biri eksikse başlık düz
+     * metin kalır
      */
     isSortable?: boolean;
     /** Sütun yatay kaydırmada YERİNDE kalır. */
@@ -533,7 +486,7 @@ export declare const DataTableRow: FC<RowProps>;
 
 export declare const DateField: typeof DateField_2;
 
-/** Tarih alanı — <strong>yerel</strong> `<input type="date">`. */
+/** Tarih alanı — yerel `<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";
@@ -551,23 +504,14 @@ export declare type DateRangeValue = {
 /** Kütüphanenin varsayılan font yığınları — hepsi sistem fontlarına iner. */
 export declare const DEFAULT_FONTS: Required<HanuiFonts>;
 
-/**
- * Bilgi yoğunluğunun taşındığı öznitelik.
- * `<html data-hanui-density="compact">`.
- */
+/** Bilgi yoğunluğunun taşındığı öznitelik. `<html data-hanui-density="compact">`. */
 export declare const DENSITY_ATTRIBUTE = "data-hanui-density";
 
 export declare const Directory: typeof Directory_2;
 
 /**
  * Dizin — harf veya konu başlıklı, gruplanmış bağlantı listesi.
- *
- * @example
- * <Directory>
- * <DirectoryGroup label="A">
- * <DirectoryRow href="/marka/ate" name="ATE" media={<img … />} />
- * </DirectoryGroup>
- * </Directory>
+ * @example <Directory> <DirectoryGroup label="A"> <DirectoryRow href="/marka/ate" name="ATE"…
  */
 declare const Directory_2: FC<DirectoryProps>;
 
@@ -577,10 +521,7 @@ export declare const DirectoryGroup: FC<DirectoryGroupProps>;
 declare type DirectoryGroupProps = {
     /** Grup başlığı: harf ("A", "0-9") veya konu ("Fren sistemi"). */
     label: string;
-    /**
-     * Başlık kendisi bir hedefe götürüyorsa. Harf gruplarında verilmez — "A"
-     * diye bir sayfa yok.
-     */
+    /** Başlık kendisi bir hedefe götürüyorsa. */
     href?: string;
     /** Yönlendiriciye geçirilecek ek props. */
     linkProps?: HanuiLinkExtraProps;
@@ -599,7 +540,7 @@ declare type DirectoryJumpProps = {
     labels: string[];
     /** Çıpa kimliğini üretir; `DirectoryGroup id` ile aynı olmalı. */
     toId: (label: string) => string;
-    /** Şeridin erişilebilir adı. Verilmezse `labels.directoryJump`. */
+    /** Şeridin erişilebilir adı. */
     label?: string;
 };
 
@@ -614,7 +555,7 @@ export declare const DirectoryRow: FC<DirectoryRowProps>;
 declare type DirectoryRowProps = {
     href: string;
     name: string;
-    /** Logo, ikon veya baş harf madalyonu. Satırın solunda. */
+    /** Logo, ikon veya baş harf madalyonu. */
     media?: ReactNode;
     /** Sağ uçta duran işaret: rozet, kayıt sayısı. */
     marker?: ReactNode;
@@ -623,36 +564,43 @@ declare type DirectoryRowProps = {
     className?: string;
 };
 
+export declare const Disclosure: typeof Disclosure_2;
+
+/**
+ * Tek başına açılır-kapanır bölüm — yerel `<details>` / `<summary>`.
+ *
+ * Klavye: `Enter` / `Space` başlıkta açar-kapar (tarayıcının kendi davranışı).
+ *
+ * ⚠ Yerel öğe bilinçli: odak, klavye ve ekran okuyucunun "genişletildi / daraltıldı" duyurusu
+ * tarayıcıdan geliyor. Taklit bir `button[aria-expanded]` bunları yeniden yazmak demekti.
+ */
+declare const Disclosure_2: FC<Props_41>;
+
+export declare type DisclosureVariant = 'framed' | 'plain';
+
 export declare const Divider: typeof Divider_2;
 
 /** Ayırıcı çizgi. */
-declare const Divider_2: FC<Props_24>;
+declare const Divider_2: FC<Props_27>;
 
 export declare const Drawer: typeof Drawer_2;
 
 /** Çekmece (drawer) — kenardan açılan kipsel panel. */
-declare const Drawer_2: ({ isOpen, onClose, title, closeLabel, children, side, size, footer, toolbar, className, testId, }: Props_46) => JSX.Element;
+declare const Drawer_2: ({ isOpen, onClose, title, closeLabel, children, side, size, footer, toolbar, className, testId, }: Props_50) => JSX.Element;
 
 export declare const EmptyState: typeof EmptyState_2;
 
 /** Boş durum. */
-declare const EmptyState_2: FC<Props_25>;
+declare const EmptyState_2: FC<Props_28>;
 
 export declare const Field: typeof Field_2;
 
 /**
  * Form alanı sarmalayıcısı.
- *
- * @example
- * <Field label="E-posta" isRequired requiredLabel="(zorunlu)" error={emailError}>
- * {props => <Input {...props} type="email" value={email} onChange={onChange} />}
- * </Field>
- *
- * @example
- * // `{...props}` yaymayan bileşenlerde (Combobox, Select) yalnızca `id`:
- * <Field label="Şehir">{props => <Combobox id={props.id} … />}</Field>
+ * @example <Field label="E-posta" isRequired requiredLabel="(zorunlu)"…
+ * @example // `{...props}` yaymayan bileşenlerde (Combobox, Select) yalnızca `id`…
  */
-declare const Field_2: FC<Props_15>;
+declare const Field_2: FC<Props_16>;
 
 /** Girdiye yayılacak erişilebilirlik bağları. */
 export declare type FieldChildProps = {
@@ -664,42 +612,33 @@ export declare type FieldChildProps = {
 
 declare type FieldProps = {
     children: ReactNode;
-    /**
-     * Alan kalan genişliği doldurur (arama kutusu). Diğer alanlar tercih
-     * ettikleri genişlikte kalır ve şerit sağa doğru boşluk bırakır.
-     */
+    /** Alan kalan genişliği doldurur (arama kutusu). */
     isWide?: boolean;
     className?: string;
 };
 
 export declare const FileUpload: typeof FileUpload_2;
 
-/** 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;
+/** Dosya yükleme — sürükle-bırak ve düğme. */
+declare const FileUpload_2: ({ files, onSelect, onRemove, label, hint, accept, isMultiple, maxSize, removeLabel, dropLabel, sizeErrorText, isDisabled, error, children, className, testId, }: Props_17) => JSX.Element;
 
 export declare const FilterBar: typeof FilterBar_2;
 
 /** Filtre şeridi. */
-declare const FilterBar_2: FC<Props_50>;
+declare const FilterBar_2: FC<Props_54>;
 
-/**
- * Şerit içindeki tek alanın genişlik sözleşmesi. İçine `Field` + girdi ya da
- * yalın `Input` konur; genişlik kararı alanın kendisine yazılmaz.
- */
+/** Şerit içindeki tek alanın genişlik sözleşmesi. */
 export declare const FilterBarField: FC<FieldProps>;
 
 /**
  * Sayı biçimlendiricileri: değere bağlı metinler dizeyle verilemez.
- *
- * ⚠ `helpers/label.helper.ts` de aynı imzayı ELLE taşıyordu. Tip
- * <strong>index.ts'ten dışa verilmiyor</strong>, yani birleştirmek genel API'yi
- * değiştirmez — ölçüldü (`npm run check:api`).
+ * ⚠ `helpers/label.helper.ts` de aynı imzayı ELLE taşıyordu.
  */
 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`).
+ * Kullanıcının SEÇİMİ. `system` = açık bir seçim yok, işletim sistemi tercihi izlenir
+ * (`prefers-color-scheme`).
  */
 export declare type HanuiColorPreference = HanuiColorScheme | 'system';
 
@@ -709,15 +648,12 @@ export declare type HanuiColorScheme = 'light' | 'dark';
 export declare type HanuiContextValue = {
     /** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
     linkComponent?: HanuiLinkComponent;
-    /** Uygulanan tema ezmeleri. Salt okunur; değiştirmek için `HanuiProvider`. */
+    /** Uygulanan tema ezmeleri. */
     theme?: HanuiThemeConfig;
     /**
-     * Arayüz metinleri. Bir bileşen metnini prop olarak almadıysa buradan okur;
-     * varsayılanlar `HanuiLabels` alanlarının yanında yazılı.
-     *
-     * ⚠ Referans bir dönem `theme/labels.ts`yi gösteriyordu; o dosya yalnızca
-     * tek satırlık bir başlık yorumu taşıyordu (sıfır export, sıfır import) ve
-     * kaldırıldı — belge var olmayan bir yeri işaret ediyordu.
+     * Arayüz metinleri.
+     * ⚠ Referans bir dönem `theme/labels.ts`yi gösteriyordu; o dosya yalnızca tek satırlık bir başlık
+     * yorumu taşıyordu (sıfır export, sıfır…
      */
     labels?: HanuiLabels;
 };
@@ -737,9 +673,8 @@ export declare type HanuiLabels = Partial<{
     close: string;
     /**
      * Bildirim yığınının bölge adı ("Bildirimler"). `ToastHub`.
-     *
-     * ⚠ Yığın bir `role="region"` ve `aria-live` bölgesi; adsız bir bölge
-     * ekran okuyucuda yalnızca "bölge" diye okunur.
+     * ⚠ Yığın bir `role="region"` ve `aria-live` bölgesi; adsız bir bölge ekran okuyucuda yalnızca
+     * "bölge" diye okunur.
      */
     notifications: string;
     /** Vazgeçme eylemi. `ConfirmDialog`, `PromptDialog`. */
@@ -793,19 +728,45 @@ export declare type HanuiLabels = Partial<{
         empty: string;
         loading: string;
     }>;
+    /**
+     * Sohbet bileşenleri (`@ahmetilhn/hanui/chat`). Çağrı yerine ÖZGÜ metinler buraya girmez:
+     * `PromptInput.placeholder`, `ReasoningBlock.summary`, `ToolCall.name`.
+     */
+    chat: Partial<{
+        /** Sohbet akışının bölge adı ("Sohbet"). `ChatThread`. */
+        thread: string;
+        /** Gönder düğmesi. `PromptInput`. */
+        send: string;
+        /** Akışı durdur düğmesi. `PromptInput`. */
+        stop: string;
+        /** Kullanıcı yukarı kaydırınca beliren düğme ("En yeniye in"). `ChatThread`. */
+        scrollToLatest: string;
+        /** Yanıt tamamlandığında duyurulan cümle ("Yanıt hazır"). `ChatThread`. */
+        replyReady: string;
+        /** Mesaj eylemleri araç çubuğunun adı. `MessageActions`. */
+        messageActions: string;
+        /** Kaynak listesinin adı ("Kaynaklar"). `SourceList`. */
+        sources: string;
+        /** Atıf numarasının okunan adı, örn. `n => 'Kaynak ' + n`. `Citation`. */
+        citation: Formatter<[index: number]>;
+        /** stderr satırının önündeki gizli işaret ("hata çıktısı"): renk tek başına anlam taşımaz. */
+        stderr: string;
+        /** Araç çağrısının durum metinleri. `ToolCall`. */
+        toolStatus: Partial<Record<'running' | 'ok' | 'error' | 'aborted' | 'interrupted', string>>;
+        /** Kod bloğunu kopyalama düğmesi, örn. `language => language + ' kodunu kopyala'`. `CodeBlock`. */
+        codeCopy: Formatter<[language: string]>;
+        /** Kopyalandıktan sonra duyurulan cümle. `CodeBlock`. */
+        codeCopied: string;
+    }>;
     copyField: Partial<{
-        /** Kopyalama düğmesinin adı. Değeri İÇERİR: bir listede on beş düğme var
-         *  ve hepsi "Kopyala" diye okunduğunda hangisi olduğu belli olmuyordu. */
+        /** Kopyalama düğmesinin adı. */
         copy: Formatter<[value: string]>;
         copied: Formatter<[value: string]>;
         announcement: string;
     }>;
     /**
      * Dosya yukleme.
-     *
      * ⚠ `tooLarge` bir BICIMLENDIRICI: mesaj dosya adini ve siniri TASIMALI.
-     * Sabit bir "cok buyuk" metni, on dosyalik bir listede hangisinin
-     * reddedildigini soylemiyordu.
      */
     fileUpload: Partial<{
         tooLarge: Formatter<[name: string, max: string]>;
@@ -816,10 +777,7 @@ export declare type HanuiLabels = Partial<{
     }>;
     /**
      * Sayisal gostergenin YON metni.
-     *
-     * ⚠ Uc deger de SR-ONLY: ok isareti gorsel bir sinyal ve ekran okuyucuya
-     * hicbir sey soylemiyor. Verilmezse gosterge "yuzde 12" der, artis mi
-     * azalis mi belirsiz kalir.
+     * ⚠ Uc deger de SR-ONLY: ok isareti gorsel bir sinyal ve ekran okuyucuya hicbir sey soylemiyor.
      */
     stat: Partial<{
         increase: string;
@@ -848,8 +806,7 @@ export declare type HanuiLabels = Partial<{
         srLabel: Formatter<[value: number, count: number | undefined]>;
         /** Puan girişinde yıldız sayısı ("4 yıldız"). */
         starCount: Formatter<[star: number]>;
-        /** Beş puanın anlamı. Dolu yıldız sayısı tek başına bir şekil sinyali;
-         *  yanındaki metin renk körü kullanıcıya ikinci bir ipucu verir. */
+        /** Beş puanın anlamı. */
         scale: Record<1 | 2 | 3 | 4 | 5, string>;
     }>;
 }>;
@@ -859,10 +816,7 @@ export declare type HanuiLinkComponent = ComponentType<HanuiLinkProps>;
 
 /**
  * Bileşenden yönlendiriciye geçirilecek ek props.
- *
- * @example
- * // Next.js App Router: sayfa numarasına basınca liste yukarı sıçramasın.
- * <Pagination linkProps={{ scroll: false }} … />
+ * @example // Next.js App Router: sayfa numarasına basınca liste yukarı sıçramasın.…
  */
 export declare type HanuiLinkExtraProps = Record<string, unknown>;
 
@@ -873,7 +827,7 @@ export declare type HanuiLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
     [key: string]: unknown;
 };
 
-/** Ölçü ezmeleri. Kısmî verilebilir; verilmeyen her ölçü varsayılanında kalır. */
+/** Ölçü ezmeleri. */
 export declare type HanuiMetrics = Partial<Record<HanuiMetricToken, string>>;
 
 /** Ölçü token adları — `METRIC_TOKENS`ten türetilir. */
@@ -881,11 +835,7 @@ export declare type HanuiMetricToken = keyof typeof METRIC_TOKENS;
 
 /**
  * Kütüphane sağlayıcısı.
- *
- * @example
- * <HanuiProvider linkComponent={NextLink} theme={{ light: { blue: '#0d6efd' } }}>
- * <App />
- * </HanuiProvider>
+ * @example <HanuiProvider linkComponent={NextLink} theme={{ light: { link: '#0a58ca' } }}> <App…
  */
 export declare const HanuiProvider: FC<Props>;
 
@@ -894,15 +844,7 @@ export declare type HanuiResolvedTokens = Record<HanuiToken, string>;
 
 /**
  * Dışarıdan verilebilecek tema yapılandırması.
- *
- * @example
- * initHanui({
- * theme: {
- * light: { blue: '#0d6efd', 'blue-text': '#0a58ca' },
- * dark:  { blue: '#6ea8fe' },
- * fonts: { heading: 'Archivo, sans-serif' },
- * },
- * });
+ * @example initHanui({ theme: { light: { link: '#0a58ca', 'ring-color': '#0d6efd' }, dark: {…
  */
 export declare type HanuiThemeConfig = Partial<{
     light: HanuiThemeTokens;
@@ -910,24 +852,32 @@ export declare type HanuiThemeConfig = Partial<{
     fonts: HanuiFonts;
     /**
      * Ölçü ezmeleri — yarıçap, boşluk, punto, süre.
-     *
-     * @example
-     * initHanui({ theme: { metrics: { 'radius-md': '2px', 'radius-lg': '4px' } } });
+     * @example initHanui({ theme: { metrics: { 'radius-md': '2px', 'radius-lg': '4px' } } });
      */
     metrics: HanuiMetrics;
 }>;
 
+/**
+ * İLK BOYAMADAN ÖNCE tema — `<head>` içine, sunucu düzeninde.
+ *
+ * Kayıtlı açık seçimi (`light` / `dark`) `<html data-hanui-theme>`e yazar; kayıt yoksa sistem
+ * tercihi izlenir. Sunucu çıktısındaki satır içi betik HTML ayrıştırılırken çalışır; React onu
+ * istemcide YENİDEN çalıştırmaz.
+ *
+ * ⚠ BİR BİLEŞEN, fonksiyon değil: paket `'use client'` taşıdığı için dışa verilen düz bir
+ * fonksiyon Next'in sunucu bileşeninde ÇAĞRILAMIYOR ("Attempted to call … from the server").
+ * Bileşen ise sunucuda da çizilir. Bu yüzden 5.1 taslağındaki `themeBootScript()` dışa verilmedi.
+ * @example <head><HanuiThemeScript storageKey="theme" /></head>
+ */
+export declare const HanuiThemeScript: FC<Props_2>;
+
 declare type HanuiThemeState = {
     /**
-     * ÇÖZÜLMÜŞ tema — ekranda çizili olan. `preference` `system` iken bu alan
-     * işletim sisteminin o anki tercihini taşır.
+     * ÇÖ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.
-     */
+    /** Kullanıcının SEÇİMİ. */
     preference: HanuiColorPreference;
     /** `'system'` verildiğinde AÇIK seçim silinir ve sistem tercihi izlenir. */
     setScheme: (preference: HanuiColorPreference) => void;
@@ -937,20 +887,28 @@ declare type HanuiThemeState = {
     isReady: boolean;
 };
 
-/** Bir temanın token → değer eşlemesi. Kısmî verilebilir; eksikler varsayılandan gelir. */
+/** Bir temanın token → değer eşlemesi. */
 export declare type HanuiThemeTokens = Partial<Record<HanuiToken, string>>;
 
 /** Token adları — `LIGHT_THEME`den türetilir, elle listelenmez. */
 export declare type HanuiToken = keyof typeof LIGHT_THEME;
 
+/**
+ * `Escape`i tüketecek AÇIK bir yüzey var mı — kipsel pencere, açılır panel, bildirim.
+ * ⚠ Sayfa düzeyinde `Escape` dinleyen her kod (sohbetin "akışı durdur" kısayolu gibi) önce bunu
+ * sorar. Sormayan bir dinleyici, kullanıcı yalnızca bir modalı kapatmak isterken arkadaki işi de
+ * iptal ediyordu. Yüzey kapanırken yığından AYNI olayın içinde değil, bir sonraki render'da
+ * çıkar; yani dinleyici o tuş vuruşunda hâlâ `true` görür — istenen de bu.
+ */
+export declare const hasOpenSurface: () => boolean;
+
 declare type HubProps = {
-    /** Kapatma düğmelerinin erişilebilir adı. Verilmezse `labels.close`. */
+    /** Kapatma düğmelerinin erişilebilir adı. */
     closeLabel?: string;
     /**
      * Yığının erişilebilir adı ("Bildirimler").
-     *
-     * ⚠ Yığın artık bir `role="region"` ve canlı bölge; adsız bir bölge ekran
-     * okuyucuda yalnızca "bölge" diye okunur.
+     * ⚠ Yığın artık bir `role="region"` ve canlı bölge; adsız bir bölge ekran okuyucuda yalnızca
+     * "bölge" diye okunur.
      */
     regionLabel?: string;
     className?: string;
@@ -963,12 +921,10 @@ declare const IconButton_2: ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLB
 icon: ReactNode;
 /** Görsel etiketi olmayan düğmenin erişilebilir adı — ZORUNLU. */
 label: string;
-/**
-* `cart` <strong>yalnızca dönüşüm eyleminde</strong> kullanılır — ekranda
-* görünen tek doygun turuncu odur. Nötr dolgu için `solid`.
-*/
+/** `cart` yalnızca dönüşüm eyleminde kullanılır — ekrandaki en parlak yeşil odur. */
 variant?: IconButtonVariant;
 size?: "sm" | "md";
+shape?: IconButtonShape;
 /** Verilirse öğe bir bağlantı olarak çizilir. */
 href?: string;
 /** Yönlendiriciye geçirilecek ek props. */
@@ -976,32 +932,23 @@ linkProps?: HanuiLinkExtraProps;
 testId?: string;
 } & RefAttributes<HTMLButtonElement>>;
 
+/** Köşe biçimi. `round` tam daire — sohbet girdisindeki gönder / durdur gibi. Ölçü değişmez. */
+declare type IconButtonShape = 'rounded' | 'round';
+
 export declare type IconButtonVariant = 'ghost' | 'outline' | 'solid' | 'cart' | 'danger';
 
 /**
- * Kütüphaneyi <strong>React ağacının dışından</strong> yapılandırır.
- *
- * @example
- * // app/layout.tsx — <head> içine, boyamadan önce.
- * <script dangerouslySetInnerHTML={{ __html: `
- * document.documentElement.dataset.hanuiTheme =
- * localStorage.getItem('theme') ?? 'light';
- * ` }} />
+ * Kütüphaneyi React ağacının dışından yapılandırır.
+ * @example // app/layout.tsx — <head> içine, boyamadan önce. <script…
  */
 export declare const initHanui: (options?: InitHanuiOptions) => void;
 
 export declare type InitHanuiOptions = Partial<{
-    /** Tema ve ölçü ezmeleri. Yalnızca değiştirilen token'lar verilir. */
+    /** Tema ve ölçü ezmeleri. */
     theme: HanuiThemeConfig;
-    /**
-     * Başlangıç şeması. Verilmezse `<html data-hanui-theme>` neyse o kalır;
-     * o da yoksa sistem tercihi (`prefers-color-scheme`) devreye girer.
-     */
+    /** Başlangıç şeması. */
     colorScheme: HanuiColorScheme;
-    /**
-     * Bilgi yoğunluğu. Verilmezse `<html data-hanui-density>` neyse o kalır;
-     * o da yoksa `default`.
-     */
+    /** Bilgi yoğunluğu. */
     density: HanuiDensity;
 }>;
 
@@ -1013,65 +960,81 @@ declare const Input_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLIn
 prefix?: ReactNode;
 /** Sağda gösterilen ikon veya birim (göz simgesi, "kg"). */
 suffix?: ReactNode;
-/** Teknik veri: SKU, kod, seri numarası — monospace ve harf aralıklı. */
+/** Teknik veri: */
 isTechnical?: boolean;
 testId?: string;
 } & RefAttributes<HTMLInputElement>>;
 
+export declare const Kbd: typeof Kbd_2;
+
+/**
+ * Klavye kısayolu — `<kbd>` içinde her tuş kendi `<kbd>`si (HTML'in birleşik tuş deseni).
+ * Ekran okuyucu "Shift artı Enter" diye okur; yalnızca görsel bir ipucuysa `aria-hidden` geçin.
+ */
+declare const Kbd_2: FC<Props_24>;
+
 /** AÇIK TEMA — varsayılan. */
 export declare const LIGHT_THEME: {
-    readonly page: "#f7fcf8";
-    readonly surface: "#fdfefd";
-    readonly 'surface-2': "#e9f7ed";
-    readonly 'surface-3': "#dff3e5";
+    readonly page: "#faf9f5";
+    readonly surface: "#fffefc";
+    readonly 'surface-2': "#efe9de";
+    readonly 'surface-3': "#e8e0d3";
     /** Girinti sayfanın ALTINA iner (arama kutusu, kod bloğu, pasif girdi). */
-    readonly 'surface-inset': "#f1faf4";
-    readonly border: "#c0eacf";
-    readonly 'border-strong': "#aaddbf";
-    readonly text: "#010f0b";
-    readonly 'text-2': "#325a4d";
-    readonly 'text-3': "#467060";
-    readonly shell: "#00322a";
-    readonly 'shell-2': "#154c3d";
-    readonly 'shell-3': "#225f4d";
+    readonly 'surface-inset': "#f5f0e8";
+    readonly border: "#ded8d0";
+    readonly 'border-strong': "#d0c8bd";
+    readonly text: "#141413";
+    readonly 'text-2': "#4d4b46";
+    readonly 'text-3': "#67655e";
+    readonly shell: "#181715";
+    readonly 'shell-2': "#1f1e1b";
+    readonly 'shell-3': "#2a2925";
+    readonly 'on-shell': "#faf9f5";
+    readonly 'on-shell-2': "#b4b1a9";
+    /** Mürekkep üzerinde hata metni (terminalin stderr'i). Açık temanın `bad-fg`i burada 2:1'in altında. */
+    readonly 'on-shell-danger': "#f2a099";
+    /** Koyu temada kabuk sayfadan 1,03:1 ayrışıyor; görünür kılan bu çizgi. */
+    readonly 'shell-line': "#33312d";
     readonly action: "#00322a";
     readonly 'action-hover': "#154c3d";
     readonly 'action-active': "#225f4d";
-    readonly 'on-action': "#fdfefd";
+    readonly 'on-action': "#fffefc";
     /** Dolgunun SINIRI; açık temada dolgunun kendisi (bkz. `ACTION_LINE`). */
     readonly 'action-line': "#00322a";
-    /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. Button `:disabled`). */
-    readonly 'action-soft': "#aaddbf";
+    /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. */
+    readonly 'action-soft': "#d0c8bd";
     /** PASİF DOLGU ÜZERİNDEKİ METİN. */
-    readonly 'on-action-soft': "#1d4238";
+    readonly 'on-action-soft': "#3d3d3a";
     readonly cart: "#1ba055";
     readonly 'cart-hover': "#20b360";
     readonly 'cart-active': "#19934e";
     readonly 'cart-soft': "#84cb97";
     readonly 'on-cart': "#021407";
-    readonly role: "#1f7b56";
-    readonly 'role-hover': "#176446";
-    readonly 'role-active': "#115037";
-    readonly 'role-text': "#17704e";
-    readonly 'role-tint': "#d5f6e4";
-    readonly 'role-line': "#93dfba";
-    readonly 'on-role': "#fdfefd";
+    readonly selected: "#141413";
+    readonly 'selected-hover': "#252523";
+    readonly 'selected-active': "#3d3d3a";
+    readonly 'on-selected': "#faf9f5";
+    /** Seçili satır / seçenek zemini — kenarlık ya da işaretle BİRLİKTE (seçim yalnız zeminle verilmez). */
+    readonly 'selected-tint': "#e8e0d3";
+    readonly 'selected-line': "#141413";
+    readonly link: "#17704e";
+    readonly 'link-hover': "#176446";
     readonly 'ok-bg': "#c2f6cf";
     readonly 'ok-fg': "#166e3a";
     readonly 'ok-line': "#7eda99";
-    readonly 'warn-bg': "#f6e4cf";
+    readonly 'warn-bg': "#f9dcb9";
     readonly 'warn-fg': "#7c5212";
     readonly 'warn-line': "#e8b97f";
-    readonly 'off-bg': "#daece5";
-    readonly 'off-fg': "#4d625a";
-    readonly 'off-line': "#afcabf";
-    readonly 'bad-bg': "#f6e2e0";
+    readonly 'off-bg': "#dcdad6";
+    readonly 'off-fg': "#5b5851";
+    readonly 'off-line': "#c5c2bb";
+    readonly 'bad-bg': "#f9d8d5";
     readonly 'bad-fg': "#a91922";
     readonly 'bad-line': "#e9b3ae";
     readonly 'oem-bg': "#a7f7c8";
     readonly 'oem-fg': "#0c5d3a";
     readonly 'oem-line': "#6ace97";
-    readonly 'alt-bg': "#e9e4f6";
+    readonly 'alt-bg': "#e5dcf9";
     readonly 'alt-fg': "#751dc8";
     readonly 'alt-line': "#c9bae7";
     readonly 'sale-bg': "#c2f6cf";
@@ -1080,28 +1043,25 @@ export declare const LIGHT_THEME: {
     readonly 'green-accent': "#18904c";
     readonly 'green-accent-hover': "#12783e";
     readonly 'on-green': "#021407";
-    readonly star: "#8c6a11";
+    readonly star: "#846310";
     readonly 'danger-solid': "#c21625";
     readonly 'danger-solid-hover': "#a2111d";
-    readonly 'on-danger': "#fdfefd";
-    readonly 'nav-bg': "#fdfefd";
-    readonly 'nav-bg-2': "#e9f7ed";
-    readonly 'nav-fg': "#010f0b";
-    readonly 'nav-fg-2': "#325a4d";
-    readonly 'nav-fg-3': "#467060";
-    readonly 'nav-line': "#d5f0de";
-    readonly 'nav-line-strong': "#aaddbf";
-    readonly 'nav-hover': "#e9f7ed";
-    readonly 'footer-bg': "#e9f7ed";
+    readonly 'on-danger': "#fffefc";
+    readonly 'nav-bg': "#faf9f5";
+    readonly 'nav-bg-2': "#efe9de";
+    readonly 'nav-fg': "#141413";
+    readonly 'nav-fg-2': "#4d4b46";
+    readonly 'nav-fg-3': "#67655e";
+    readonly 'nav-line': "#e4dfd8";
+    readonly 'nav-line-strong': "#d0c8bd";
+    readonly 'nav-hover': "#efe9de";
+    readonly 'footer-bg': "#efe9de";
     readonly 'band-bg': "#00322a";
     readonly 'band-fg': "#e9f7ed";
     readonly 'band-fg-2': "#8abaa1";
     /**
-     * Bandın ÜÇÜNCÜ metin kademesi ve imza vurgusu.
-     *
-     * <p>Panelin kenar çubuğu rayı bu ikisini bir dönem SABİT HEX olarak
-     * taşıyordu (`#799a8f`, `#43ff9c`) — uygulamada kalan son renk
-     * literalleriydi ve paletten bağımsız hareket ediyorlardı.
+     * Bandın ÜÇÜNCÜ metin kademesi ve imza vurgusu. Panelin kenar çubuğu rayı bu ikisini bir dönem
+     * SABİT HEX olarak taşıyordu (`#799a8f`, `#43ff9c`)
      */
     readonly 'band-fg-3': "#79a790";
     readonly 'band-accent': "#43ff9c";
@@ -1114,7 +1074,7 @@ export declare const LIGHT_THEME: {
     readonly 'shadow-xl': `0 8px 16px ${string}, 0 28px 56px ${string}`;
     /** Yapışkan alt bar; gölge YUKARI düşer. */
     readonly 'shadow-up': `0 -2px 4px ${string}, 0 -8px 24px ${string}`;
-    /** Odak halkası MAVİ: odak bir gezinme olayıdır, bir dönüşüm değil. */
+    /** Odak halkası BAĞLANTI YEŞİLİ: odak bir gezinme olayıdır. Çam DEĞİL — birincil dolguyla aynı ton. */
     readonly ring: `0 0 0 3px ${string}`;
     readonly 'ring-color': "#1f7b56";
     readonly 'ring-danger': `0 0 0 3px ${string}`;
@@ -1122,16 +1082,23 @@ export declare const LIGHT_THEME: {
     readonly scrim: string;
     readonly 'scrim-soft': string;
     readonly glass: string;
-    readonly 'glass-solid': "#fdfefd";
-    readonly 'on-scrim': "#fdfefd";
-    readonly 'skeleton-a': "#e9f7ed";
-    readonly 'skeleton-b': "#f7fcf8";
+    readonly 'glass-solid': "#fffefc";
+    readonly 'on-scrim': "#fffefc";
+    readonly 'skeleton-a': "#efe9de";
+    readonly 'skeleton-b': "#faf9f5";
     readonly track: string;
     /** Görsel yer tutucu (medya yoksa). */
-    readonly 'media-bg': "#e9f7ed";
+    readonly 'media-bg': "#efe9de";
     readonly 'glow-1': string;
     readonly 'glow-2': string;
     readonly 'glow-cart': string;
+    readonly 'cat-1': "#2774cd";
+    readonly 'cat-2': "#b75225";
+    readonly 'cat-3': "#2c8761";
+    readonly 'cat-4': "#8b7126";
+    readonly 'cat-5': "#c02f8f";
+    readonly 'series-1': "#252523";
+    readonly 'series-2': "#8f3beb";
 };
 
 declare type LinkProps = BaseProps_4 & {
@@ -1151,7 +1118,7 @@ export declare type ListboxNavigation<T extends HTMLElement = HTMLElement> = {
 };
 
 export declare type ListboxNavigationOptions = {
-    /** Seçenek sayısı. Liste süzüldüğünde değişir. */
+    /** Seçenek sayısı. */
     count: number;
     isOpen: boolean;
     /** Açılışta etkin olacak dizin — genellikle seçili olan. */
@@ -1167,7 +1134,7 @@ export declare const matchesSearch: (haystack: string, needle: string) => boolea
 export declare const Menu: typeof Menu_2;
 
 /** Menü — bir listeden EYLEM seçme. */
-declare const Menu_2: ({ trigger, items, label, side, align, className, testId, }: Props_4) => JSX.Element | null;
+declare const Menu_2: ({ trigger, items, label, side, align, className, testId, }: Props_5) => JSX.Element | null;
 
 export declare type MenuItem = {
     id: string;
@@ -1187,12 +1154,7 @@ export declare const METRIC_TOKENS: {
     readonly 'radius-lg': "12px";
     readonly 'radius-xl': "16px";
     readonly 'radius-pill': "999px";
-    /**
-     * YOĞUNLUK ÇARPANLARI — akışkan ölçeğin üzerine binen tek ayar.
-     *
-     * <p>Varsayılan `1`, yani hiçbir şeyi değiştirmez; `data-hanui-density`
-     * ya da tüketicinin kendi metrik ezmesi bunları düşürür.
-     */
+    /** YOĞUNLUK ÇARPANLARI — akışkan ölçeğin üzerine binen tek ayar. */
     readonly 'type-scale': "1";
     readonly 'space-scale': "1";
     readonly 'space-0': "0";
@@ -1215,17 +1177,7 @@ export declare const METRIC_TOKENS: {
     readonly 'font-size-2xl': string;
     readonly 'font-size-3xl': string;
     readonly 'font-size-4xl': string;
-    /**
-     * FORM DENETİMİ PUNTOSU — ölçekten AYRI ve 16px'in altına inmez.
-     *
-     * <p>⚠ iOS Safari, hesaplanan puntosu 16px'in ALTINDA olan bir `input`a
-     * odaklanıldığında sayfayı zorla yakınlaştırır ve geri çıkmaz. `font-size-base`
-     * akışkan olunca dar ekranda 15px'e iniyor, yani bu düzeltme olmadan
-     * **telefonda her form alanı sayfayı zıplatırdı.**
-     *
-     * <p>`max()` kullanılıyor çünkü ölçek büyüdüğünde denetim de büyümeli;
-     * sabit `16px` yazmak üst uçta alanı ölçeğin gerisinde bırakırdı.
-     */
+    /** FORM DENETİMİ PUNTOSU — ölçekten AYRI ve 16px'in altına inmez. */
     readonly 'font-size-control': `max(16px, ${string})`;
     readonly 'leading-none': "1";
     readonly 'leading-tight': "1.16";
@@ -1246,18 +1198,17 @@ export declare const METRIC_TOKENS: {
     readonly 'ease-spring': "cubic-bezier(0.34, 1.4, 0.64, 1)";
     readonly 'duration-spin': "700ms";
     readonly 'duration-shimmer': "1400ms";
+    /** Durum noktasının nabzı — "çalışıyor / bağlanıyor"; 700 ms telaş, 2 sn ölü gibi okunuyordu. */
+    readonly 'duration-pulse': "1600ms";
 };
 
-/**
- * Kırılma noktaları — `styles/_variables.scss` içindeki `$breakpoint-*` ile
- * <strong>aynı</strong> değerler.
- */
+/** Kırılma noktaları — `styles/_variables.scss` içindeki `$breakpoint-*` ile aynı değerler. */
 export declare const MOBILE_BREAKPOINT = 640;
 
 export declare const Modal: typeof Modal_2;
 
 /** Kip pencere (modal). */
-declare const Modal_2: ({ isOpen, onClose, title, closeLabel, children, description, footer, icon, tone, size, isDismissable, className, testId, }: Props_43) => JSX.Element;
+declare const Modal_2: ({ isOpen, onClose, title, closeLabel, children, description, footer, icon, tone, size, isDismissable, className, testId, }: Props_47) => JSX.Element;
 
 export declare type ModalTone = 'neutral' | 'danger' | 'warning' | 'success' | 'info';
 
@@ -1267,30 +1218,26 @@ 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ış. */
+/** Serbest metin arama anahtarı: */
 export declare const normalizeSearchTerm: (value: string) => string;
 
 export declare const PageHeader: typeof PageHeader_2;
 
 /** Sayfa başlığı — her ekranın aynı giriş bloğu. */
-declare const PageHeader_2: FC<Props_26>;
+declare const PageHeader_2: FC<Props_29>;
 
 export declare const Pagination: typeof Pagination_2;
 
 /** Sayfalama. */
-declare const Pagination_2: FC<Props_51>;
+declare const Pagination_2: FC<Props_55>;
 
 export declare const Panel: typeof Panel_2;
 
 /**
  * Panel — başlığı olan içerik kutusu.
- *
- * @example
- * <Panel title="Profil bilgileri" description="Fatura bu bilgilerle kesilir">
- * <PanelForm>…alanlar…</PanelForm>
- * </Panel>
+ * @example <Panel title="Profil bilgileri" description="Fatura bu bilgilerle kesilir">…
  */
-declare const Panel_2: FC<Props_27>;
+declare const Panel_2: FC<Props_30>;
 
 /** Panel içindeki form ızgarası. */
 export declare const PanelForm: FC<PanelFormProps>;
@@ -1302,7 +1249,7 @@ declare type PanelFormProps = {
     className?: string;
 };
 
-/** İki alanı yan yana koyan satır. Dar ekranda alt alta düşer. */
+/** İki alanı yan yana koyan satır. */
 export declare const PanelRow: FC<PanelRowProps>;
 
 declare type PanelRowProps = {
@@ -1313,18 +1260,15 @@ declare type PanelRowProps = {
 export declare const PasswordInput: typeof PasswordInput_2;
 
 /**
- * Şifre girdisi — yanında göz düğmesi.
- *
- * `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.
+ * Şifre girdisi — yanında göz düğmesi. `hanparca-admin` ve `hanparca-frontend`te BİREBİR AYNI dosya
+ * olarak duruyordu
  */
-declare const PasswordInput_2: FC<Props_13>;
+declare const PasswordInput_2: FC<Props_14>;
 
 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;
+/** Popover — eylem taşıyabilen, odaklanabilir yüzey. */
+declare const Popover_2: ({ trigger, children, label, side, align, isOpen: controlledOpen, onOpenChange, className, testId, }: Props_6) => JSX.Element | null;
 
 /** Tercih edilen kenar boyunca hizalama. */
 export declare type PositionAlign = 'start' | 'center' | 'end';
@@ -1350,55 +1294,42 @@ export declare type PositioningState = {
     /** ÇÖZÜLMÜŞ kenar: çarpışma yüzünden tercih edilenin karşıtı olabilir. */
     side: PositionSide;
     /**
-     * Tetikleyicinin ölçülen genişliği (px) — açılır listeler panelin genişliğini
-     * buna bağlıyor.
-     *
-     * ⚠ ÖLÇÜM BURADA, ÇAĞIRANDA DEĞİL. `Combobox` ve `Select` bu değeri render
-     * sırasında `triggerRef.current?.offsetWidth` ile okuyordu; render sırasında
-     * DOM okumak iki şeyi birden kırıyor: ilk render'da ref henüz boş olabilir
-     * (`undefined` genişlik) ve değer bir daha GÜNCELLENMEZ — pencere yeniden
-     * boyutlandığında ya da yazı tipi geldiğinde panel bayat genişlikte kalır.
-     * Kanca tetikleyiciyi `ResizeObserver` ile zaten izliyor, yani ölçüm burada
-     * bedavaya reaktif.
+     * Tetikleyicinin ölçülen genişliği (px) — açılır listeler panelin genişliğini buna bağlıyor.
+     * ⚠ ÖLÇÜM BURADA, ÇAĞIRANDA DEĞİL. `Combobox` ve `Select` bu değeri render sırasında
+     * `triggerRef.current?.offsetWidth` ile okuyordu
      */
     anchorWidth: number;
-    /** İlk ölçüm yapıldı mı. Yapılmadan çizilen yüzey sol üst köşede parlıyor. */
+    /** İlk ölçüm yapıldı mı. */
     isPositioned: boolean;
 };
 
-/** Yüzeyin tercih ettiği kenar. Yer yoksa karşıtına düşer. */
+/** Yüzeyin tercih ettiği kenar. */
 export declare type PositionSide = 'top' | 'bottom' | 'left' | 'right';
 
 export declare const Price: typeof Price_2;
 
 /** Tutar gösterimi. */
-declare const Price_2: FC<Props_28>;
+declare const Price_2: FC<Props_31>;
 
 export declare const Progress: typeof Progress_2;
 
-/** İlerleme çubuğu — <strong>ölçülebilir</strong> bekleme. */
-declare const Progress_2: ({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: Props_35) => JSX.Element;
+/** İlerleme çubuğu — ölçülebilir bekleme. */
+declare const Progress_2: ({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: Props_38) => 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. */
-declare const PromptDialog_2: FC<Props_47>;
+declare const PromptDialog_2: FC<Props_51>;
 
 declare type Props = {
     children: ReactNode;
-    /**
-     * Tema ezmeleri. Yalnızca DEĞİŞTİRİLEN token'lar verilir; verilmeyen her
-     * token varsayılanında kalır.
-     */
+    /** Tema ezmeleri. */
     theme?: HanuiThemeConfig;
     /**
-     * Tüketicinin bağlantı bileşeni. Verilmezse ham `<a>` çizilir.
-     *
-     * @example
-     * import NextLink from 'next/link';
-     * <HanuiProvider linkComponent={NextLink}>…</HanuiProvider>
+     * Tüketicinin bağlantı bileşeni.
+     * @example import NextLink from 'next/link'; <HanuiProvider linkComponent={NextLink}>…</Ha…
      */
     linkComponent?: HanuiLinkComponent;
     /** Arayüz metinleri — bir kez, burada. */
@@ -1406,54 +1337,58 @@ declare type Props = {
 };
 
 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;
     value: RangeValue;
     /** Sürükleme sürerken her adımda çağrılır — ekrandaki değeri günceller. */
     onChange: (value: RangeValue) => void;
-    /**
-     * Sürükleme <em>bittiğinde</em> çağrılır. Adres çubuğuna yazmak veya
-     * sunucuya istek atmak gibi pahalı işler buraya bağlanır.
-     */
+    /** Sürükleme bittiğinde çağrılır. */
     onCommit?: (value: RangeValue) => void;
     /** Ham sayıyı okunur metne çevirir ("125000" → "1.250 TL"). */
     formatValue?: (value: number) => string;
     /** Grubun erişilebilir adı ("Fiyat aralığı"). */
     label: string;
-    /** Alt kulbun erişilebilir ad eki. Verilmezse `labels.range.min`. */
+    /** Alt kulbun erişilebilir ad eki. */
     minLabel?: string;
-    /** Üst kulbun erişilebilir ad eki. Verilmezse `labels.range.max`. */
+    /** Üst kulbun erişilebilir ad eki. */
     maxLabel?: string;
     isDisabled?: boolean;
     className?: string;
     testId?: string;
 };
 
-declare type Props_11 = {
+declare type Props_12 = {
     value: number | null;
     onChange: (value: number) => void;
     /** Grubun erişilebilir adı ("Ürün puanı"). */
     label: string;
     /**
-     * Puan açıklamaları. Hem ekran okuyucuya okunur hem de seçildiğinde
-     * yıldızların altında yazar. Verilmezse `labels.rating.scale`.
+     * Puan açıklamaları. Hem ekran okuyucuya okunur hem de seçildiğinde yıldızların altında yazar.
      */
     ratingLabels?: RatingLabels;
-    /**
-     * Ekran okuyucuda yıldız sayısını okuyan biçimlendirici ("4 yıldız").
-     * Verilmezse `labels.rating.starCount`.
-     */
+    /** Ekran okuyucuda yıldız sayısını okuyan biçimlendirici ("4 yıldız"). */
     formatStarCount?: (star: number) => string;
     isDisabled?: boolean;
     className?: string;
     testId?: string;
 };
 
-declare type Props_12 = {
+declare type Props_13 = {
     value: number;
     onChange: (value: number) => void;
-    /** Grubun ve girdinin erişilebilir adı. Verilmezse `labels.quantity.label`. */
+    /** Grubun ve girdinin erişilebilir adı. */
     label?: string;
     /** Verilmezse `labels.quantity.decrease`. */
     decreaseLabel?: string;
@@ -1467,28 +1402,28 @@ declare type Props_12 = {
     testId?: string;
 };
 
-declare type Props_13 = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
+declare type Props_14 = 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 = {
+declare type Props_15 = {
     values: string[];
     onChange: (values: string[]) => void;
-    /** Alanın erişilebilir adı. ZORUNLU. */
+    /** Alanın erişilebilir adı. */
     label: string;
     placeholder?: string;
-    /** Her etiketin kaldırma düğmesinin ad öneki ("Kaldır"). ZORUNLU. */
+    /** Her etiketin kaldırma düğmesinin ad öneki ("Kaldır"). */
     removeLabel: string;
-    /** Etiketi bitiren tuşlar. Varsayılan `Enter` ve virgül. */
+    /** Etiketi bitiren tuşlar. */
     separators?: string[];
-    /** En fazla kaç etiket. Dolduğunda girdi PASİF olur, gizlenmez. */
+    /** En fazla kaç etiket. */
     maxTags?: number;
     isDisabled?: boolean;
     id?: string;
-    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. Bkz. `Select.required`. */
+    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. */
     required?: boolean;
     'aria-describedby'?: string;
     'aria-invalid'?: boolean;
@@ -1496,25 +1431,25 @@ declare type Props_14 = {
     testId?: string;
 };
 
-declare type Props_15 = BaseProps_2 & {
+declare type Props_16 = BaseProps_2 & {
     isRequired?: boolean;
     /** Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)"). */
     requiredLabel?: string;
 };
 
-declare type Props_16 = {
+declare type Props_17 = {
     files: UploadFile[];
     /** Kullanıcı dosya seçtiğinde/bıraktığında çağrılır — DOĞRULANMIŞ liste. */
     onSelect: (files: File[]) => void;
     onRemove: (id: string) => void;
-    /** Alanın görünür etiketi ve erişilebilir adı. ZORUNLU. */
+    /** Alanın görünür etiketi ve erişilebilir adı. */
     label: string;
     /** Etiketin altındaki kural cümlesi ("PDF veya JPG, en fazla 5 MB"). */
     hint?: string;
     /** `<input accept>` — tarayıcının dosya seçicisini süzer. */
     accept?: string;
     isMultiple?: boolean;
-    /** Bayt. Aşan dosya `onSelect`e HİÇ ulaşmaz; hata metni burada üretilir. */
+    /** Bayt. */
     maxSize?: number;
     /** Kaldırma düğmelerinin erişilebilir ad öneki ("Kaldır"). */
     removeLabel: string;
@@ -1530,7 +1465,7 @@ declare type Props_16 = {
     testId?: string;
 };
 
-declare type Props_17 = {
+declare type Props_18 = {
     children: ReactNode;
     tone?: AlertTone;
     title?: string;
@@ -1540,14 +1475,15 @@ declare type Props_17 = {
     testId?: string;
 };
 
-declare type Props_18 = {
-    /** Tam ad; baş harfler buradan üretilir ve görsel yoksa `alt` metnidir. */
+declare type Props_19 = {
+    /** Tam ad; baş harfler buradan üretilir ve her durumda okunan addır (`aria-label`). */
     name: string;
-    /**
-     * Profil görseli. Verilmezse baş harf madalyonuna düşer — çağıran tarafın
-     * koşul yazması gerekmez.
-     */
+    /** Profil görseli. */
     imageUrl?: string;
+    /** Baş harf yerine ikon (marka işareti, sistem kullanıcısı). Görselden önce gelmez. */
+    icon?: ReactNode;
+    shape?: AvatarShape;
+    tone?: AvatarTone;
     /** Baş harfleri büyütürken kullanılacak dil etiketi ("tr", "az"). */
     locale?: string;
     size?: 'sm' | 'md' | 'lg';
@@ -1555,7 +1491,12 @@ declare type Props_18 = {
     testId?: string;
 };
 
-declare type Props_19 = {
+declare type Props_2 = {
+    /** Kullanıcının seçiminin tutulduğu `localStorage` anahtarı. */
+    storageKey: string;
+};
+
+declare type Props_20 = {
     children: ReactNode;
     tone?: BadgeTone;
     variant?: BadgeVariant;
@@ -1565,20 +1506,9 @@ declare type Props_19 = {
     testId?: string;
 };
 
-declare type Props_2 = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {
-    href: string;
-    children: ReactNode;
-    /** Sonda ok gösterilir — "devam et" anlamı taşıyan bağlantılarda. */
-    hasArrow?: boolean;
-    tone?: 'brand' | 'muted';
-    size?: 'sm' | 'md';
-    /** Yönlendiriciye geçirilecek ek props. */
-    linkProps?: HanuiLinkExtraProps;
-};
-
-declare type Props_20 = {
+declare type Props_21 = {
     items: Crumb[];
-    /** Gezinme bölgesinin erişilebilir adı. Verilmezse `labels.breadcrumb`. */
+    /** Gezinme bölgesinin erişilebilir adı. */
     label?: string;
     /** Yönlendiriciye geçirilecek ek props. */
     linkProps?: HanuiLinkExtraProps;
@@ -1586,55 +1516,78 @@ declare type Props_20 = {
     testId?: string;
 };
 
-declare type Props_21 = {
+declare type Props_22 = {
     children: ReactNode;
-    /** Şeridin erişilebilir adı ("Öne çıkan ürünler"). ZORUNLU. */
+    /** Şeridin erişilebilir adı ("Öne çıkan ürünler"). */
     label: string;
-    /** Önceki/sonraki düğmelerinin erişilebilir adları. ZORUNLU. */
+    /** Önceki/sonraki düğmelerinin erişilebilir adları. */
     previousLabel: string;
     nextLabel: string;
     /** Sayfa göstergesinin ad üreticisi (`index` 1 tabanlı). */
     formatDotLabel?: (index: number, total: number) => string;
-    /**
-     * Bir kartın genişliği. Şerit her kartı bu genişlikte çizer.
-     * Duyarlı genişlik ya da "yarım kart görünsün" gibi bir ölçü gerekiyorsa
-     * CSS'ten `--hanui-carousel-item` ezilir; buradaki değer yalnızca varsayılan.
-     */
+    /** Bir kartın genişliği. Şerit her kartı bu genişlikte çizer. */
     itemWidth?: number;
     /**
-     * @deprecated `itemWidth` kullanın. Ad bir ASGARİ genişlik vaat ediyordu ama
-     * şerit artık kartları germiyor: verilen değer kartın genişliğinin kendisi.
-     * Eski yol bir sürüm daha çalışır; `CLAUDE.md` → Göç.
+     * @deprecated `itemWidth` kullanın. Ad bir ASGARİ genişlik vaat ediyordu ama şerit artık
+     * kartları…
      */
     itemMinWidth?: number;
     className?: string;
     testId?: string;
 };
 
-declare type Props_22 = {
+declare type Props_23 = {
     /** Gösterilecek teknik kod (arıza kodu, parça numarası, şase). */
     code: string;
     /** Kopyalama düğmesi ekler. */
     isCopyable?: boolean;
-    /** Kopyalama düğmesinin erişilebilir adı. Verilmezse `labels.copyField.copy(code)`. */
+    /** Kopyalama düğmesinin erişilebilir adı. */
     copyLabel?: string;
-    /** Kopyalandıktan sonraki ad. Verilmezse `labels.copyField.copied(code)`. */
+    /** Kopyalandıktan sonraki ad. */
     copiedLabel?: string;
-    /** `aria-live` ile duyurulan onay cümlesi. Verilmezse `labels.copyField.announcement`. */
+    /** `aria-live` ile duyurulan onay cümlesi. */
     copiedAnnouncement?: string;
     size?: CodeBadgeSize;
+    /** Kodu ETKİLEŞİMLİ yapar (kaynağı aç, ayrıntıya git): kod bir düğme olur. */
+    onClick?: () => void;
+    /** Kodu bir BAĞLANTI yapar; `onClick` ile birlikte verilmez. */
+    href?: string;
+    linkProps?: HanuiLinkExtraProps;
+    /**
+     * Etkileşimli kodun okunan adı. Kısa kimliklerde ("A3") kod tek başına ne açılacağını söylemez
+     * ("A3 kaynağını aç"). Verilmezse kodun kendisi.
+     */
+    label?: string;
     className?: string;
     testId?: string;
 };
 
-declare type Props_23 = {
+declare type Props_24 = Omit<HTMLAttributes<HTMLElement>, 'children'> & {
+    /** Basılacak tuşlar, sırayla: `['Shift', 'Enter']`. Tek tuş da bir dizi: `['⌘K']`. */
+    keys: string[];
+};
+
+declare type Props_25 = {
+    tone?: StatusDotTone;
+    /**
+     * Durumun okunan adı ("Bağlı", "Çalışıyor"). ZORUNLU: nokta yalnızca renk ve renk tek başına
+     * anlam taşıyamaz (WCAG 1.4.1). Görsel olarak gizli metin olarak yazılır.
+     */
+    label: string;
+    /** Süren bir iş — "çalışıyor", "bağlanıyor". Azaltılmış harekette durur. */
+    isPulsing?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_26 = {
     /** Gösterilecek ve panoya kopyalanacak değer. */
     value: string;
     /** Kopyalama düğmesinin erişilebilir adı. */
     copyLabel?: string;
-    /** Kopyalandıktan sonraki ad. Verilmezse `labels.copyField.copied(value)`. */
+    /** Kopyalandıktan sonraki ad. */
     copiedLabel?: string;
-    /** `aria-live` ile duyurulan onay cümlesi. Verilmezse `labels.copyField.announcement`. */
+    /** `aria-live` ile duyurulan onay cümlesi. */
     copiedAnnouncement?: string;
     size?: 'sm' | 'md';
     /** Kopyalama düğmesini gizler. */
@@ -1643,13 +1596,13 @@ declare type Props_23 = {
     testId?: string;
 };
 
-declare type Props_24 = {
+declare type Props_27 = {
     /** Ortada gösterilen metin ("veya"). */
     label?: string;
     className?: string;
 };
 
-declare type Props_25 = {
+declare type Props_28 = {
     title: string;
     description?: string;
     icon?: ReactNode;
@@ -1664,20 +1617,17 @@ declare type Props_25 = {
     testId?: string;
 };
 
-declare type Props_26 = {
+declare type Props_29 = {
     title: string;
     /** Başlığın üstündeki küçük bağlam etiketi ("HESABIM", "KATEGORİ"). */
     eyebrow?: string;
     /** Bir cümlelik açıklama. 68ch ile sınırlı tutulur. */
     description?: ReactNode;
-    /** Sağ tarafta duran eylemler. Dar ekranda başlığın altına düşer. */
+    /** Sağ tarafta duran eylemler. */
     actions?: ReactNode;
     /** Başlık satırının üstündeki kırıntı yolu. */
     breadcrumb?: ReactNode;
-    /**
-     * Başlığın yanındaki sayaç ("1.248 kayıt"). Açıklamanın değil BAŞLIĞIN
-     * hizasında durur; kullanıcı sayıyı başlıkla birlikte okur.
-     */
+    /** Başlığın yanındaki sayaç ("1.248 kayıt"). */
     meta?: ReactNode;
     /** Başlık bloğunun altında duran ek içerik (filtre şeridi, sekmeler). */
     children?: ReactNode;
@@ -1687,9 +1637,20 @@ declare type Props_26 = {
     testId?: string;
 };
 
-declare type Props_27 = {
+declare type Props_3 = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {
+    href: string;
     children: ReactNode;
-    /** Panel başlığı. Verilmezse başlık şeridi hiç çizilmez. */
+    /** Sonda ok gösterilir — "devam et" anlamı taşıyan bağlantılarda. */
+    hasArrow?: boolean;
+    tone?: 'brand' | 'muted';
+    size?: 'sm' | 'md';
+    /** Yönlendiriciye geçirilecek ek props. */
+    linkProps?: HanuiLinkExtraProps;
+};
+
+declare type Props_30 = {
+    children: ReactNode;
+    /** Panel başlığı. */
     title?: string;
     /** Başlık altındaki tek satırlık açıklama. */
     description?: ReactNode;
@@ -1709,10 +1670,10 @@ declare type Props_27 = {
     testId?: string;
 };
 
-declare type Props_28 = {
-    /** BİÇİMLENMİŞ tutar: "1.299,90". Bileşen hesap yapmaz. */
+declare type Props_31 = {
+    /** BİÇİMLENMİŞ tutar: "1.299,90". */
     value: string;
-    /** Para birimi simgesi ya da kodu. Verilmezse `labels.currency`. */
+    /** Para birimi simgesi ya da kodu. */
     currency?: string;
     /** Değeri `Intl.NumberFormat` ile biçimlendirir. */
     isFormatted?: boolean;
@@ -1727,8 +1688,8 @@ declare type Props_28 = {
     testId?: string;
 };
 
-declare type Props_29 = {
-    /** 0–5 arası puan. Yarım yıldız desteklenir. */
+declare type Props_32 = {
+    /** 0–5 arası puan. */
     value: number;
     /** Değerlendirme sayısı; verilirse yıldızların yanında gösterilir. */
     count?: number;
@@ -1739,34 +1700,7 @@ declare type Props_29 = {
     testId?: string;
 };
 
-declare type Props_3 = {
-    /** Balonda gösterilecek açıklama. */
-    content: ReactNode;
-    /** Açıklamanın bağlandığı öğe — düğme, ikon, etiket. */
-    children: ReactNode;
-    /**
-     * Tercih edilen kenar. Yer yoksa KARŞITINA düşer; üçüncü bir kenara
-     * atlamaz (bkz. `usePositioning`).
-     */
-    side?: PositionSide;
-    /**
-     * Açılma gecikmesi (ms). Fare bir araç çubuğunun üzerinden geçerken sıfır
-     * gecikme, art arda beş balon açıp kapatıyordu.
-     */
-    openDelay?: number;
-    /**
-     * @deprecated `side` kullanın. Bu prop bir sonraki büyük sürümde kalkacak.
-     *
-     * <p>Ad değişti çünkü davranış değişti: `position` SABİT bir kenar
-     * yazıyordu ve balon oraya sığmadığında görünüm alanının dışına taşıyordu.
-     * `side` yalnızca TERCİH — yer yoksa karşıt kenara düşülüyor. Aynı adı
-     * korumak, artık doğru olmayan bir sözü sürdürmek olurdu.
-     */
-    position?: 'top' | 'bottom';
-    className?: string;
-};
-
-declare type Props_30 = {
+declare type Props_33 = {
     title: string;
     description?: string;
     /** Üstte gösterilen küçük büyük-harf etiket. */
@@ -1779,9 +1713,9 @@ declare type Props_30 = {
     testId?: string;
 };
 
-declare type Props_31 = {
+declare type Props_34 = {
     children: ReactNode;
-    /** Kaydırılabilir bölgenin erişilebilir adı. ZORUNLU. */
+    /** Kaydırılabilir bölgenin erişilebilir adı. */
     label: string;
     /** Kaydırma yönü. `both` iki eksende de kaydırır. */
     axis?: 'vertical' | 'horizontal' | 'both';
@@ -1789,11 +1723,16 @@ declare type Props_31 = {
     maxHeight?: number | string;
     /** Kenarlarda içeriğin devam ettiğini gösteren solma. */
     hasFade?: boolean;
+    /**
+     * SONA yapışık kalır — içerik büyüdükçe aşağı iner, kullanıcı yukarı kaydırınca bırakır, sona
+     * dönünce yeniden yapışır (akan akıl yürütme, canlı terminal çıktısı). Yalnızca dikey eksende.
+     */
+    isFollowingEnd?: boolean;
     className?: string;
     testId?: string;
 };
 
-declare type Props_32 = {
+declare type Props_35 = {
     /** Genişlik: sayı px, dize doğrudan CSS değeri. */
     width?: number | string;
     height?: number | string;
@@ -1804,10 +1743,10 @@ declare type Props_32 = {
     className?: string;
 };
 
-declare type Props_33 = {
+declare type Props_36 = {
     /** Ölçülen şeyin adı ("Bugünkü sipariş"). */
     label: string;
-    /** Değerin KENDİSİ — biçimlendirilmiş dize. Bileşen hesap yapmaz. */
+    /** Değerin KENDİSİ — biçimlendirilmiş dize. */
     value: ReactNode;
     /** Değerin yanındaki birim ("₺", "adet"). */
     unit?: string;
@@ -1815,23 +1754,24 @@ declare type Props_33 = {
     delta?: string;
     /** Değişimin yönü. */
     trend?: StatTrend;
-    /** Artış İYİ mi. Varsayılan `true`. */
+    /** Artış İYİ mi. */
     isUpPositive?: boolean;
     /** Değerin altındaki bir cümlelik bağlam ("geçen haftaya göre"). */
     description?: ReactNode;
     /** Sol üstte duran ikon madalyonu. */
     icon?: ReactNode;
     /**
-     * `plain` KUTUYU kaldırır: zemin, kenarlık ve dolgu gider, yalnızca sayı
-     * kalır. Varsayılan `card`.
+     * `plain` KUTUYU kaldırır: zemin, kenarlık ve dolgu gider, yalnızca sayı kalır.
+     * `inline` etiketi ve değeri TEK SATIRA dizer, değer teknik fontta — metrik satırı ("Gecikme
+     * 412 ms"). Değişim ve açıklama bu kipte de çizilir, satırı uzatır.
      */
-    variant?: 'card' | 'plain';
+    variant?: 'card' | 'plain' | 'inline';
     size?: 'sm' | 'md';
     className?: string;
     testId?: string;
 };
 
-declare type Props_34 = {
+declare type Props_37 = {
     /** Kart başlığı — aynı zamanda bağlantı metni. */
     title: string;
     href: string;
@@ -1849,34 +1789,57 @@ declare type Props_34 = {
     testId?: string;
 };
 
-declare type Props_35 = {
+declare type Props_38 = {
     /**
-     * Tamamlanan miktar. `undefined` → BELİRSİZ ilerleme (sonu bilinmiyor);
-     * çubuk kendi kendine akar.
+     * Tamamlanan miktar. `undefined` → BELİRSİZ ilerleme (sonu bilinmiyor); çubuk kendi kendine akar.
      */
     value?: number;
     /** Ölçeğin üst ucu. */
     max?: number;
-    /** Çubuğun erişilebilir adı ("Yükleme", "Ödeme adımı"). ZORUNLU. */
+    /** Çubuğun erişilebilir adı ("Yükleme", "Ödeme adımı"). */
     label: string;
     /** 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;
+    /**
+     * ⚠ `brand` 5.0'dan beri MÜREKKEP çizer (`selected` — ilerleme bir seçim göstergesi), yeşil
+     * DEĞİL: yeşil yalnızca eylem, bağlantı ve odakta. Ad 4.x'ten kaldı; değiştirmek her çağrıyı
+     * kırardı ve kazancı yalnızca isim olurdu.
+     */
     tone?: 'brand' | 'success' | 'warning' | 'danger';
-    size?: 'sm' | 'md';
+    /** `xs` 2 px — satır içi gösterge (bağlam doluluğu); etiket yanında okunur. */
+    size?: 'xs' | 'sm' | 'md';
     className?: string;
     testId?: string;
 };
 
-declare type Props_36 = {
+declare type Props_39 = {
     size?: 'sm' | 'md' | 'lg';
     /** Ekran okuyucuya okunacak metin; görsel olarak gizli. */
     label?: string;
     className?: string;
 };
 
-declare type Props_37 = {
+declare type Props_4 = {
+    /** Balonda gösterilecek açıklama. */
+    content: ReactNode;
+    /** Açıklamanın bağlandığı öğe — düğme, ikon, etiket. */
+    children: ReactNode;
+    /** Tercih edilen kenar. */
+    side?: PositionSide;
+    /** Açılma gecikmesi (ms). */
+    openDelay?: number;
+    /**
+     * Ad değişti çünkü davranış değişti: `position` SABİT bir kenar yazıyordu ve balon oraya
+     * sığmadığında görünüm alanının dışına taşıyordu. `side`…
+     * @deprecated `side` kullanın.
+     */
+    position?: 'top' | 'bottom';
+    className?: string;
+};
+
+declare type Props_40 = {
     items: AccordionItem[];
     /** Aynı anda YALNIZCA BİR bölüm açık kalır. */
     isSingle?: boolean;
@@ -1889,29 +1852,42 @@ declare type Props_37 = {
     testId?: string;
 };
 
-declare type Props_38 = {
-    steps: StepItem[];
+declare type Props_41 = {
+    /** Başlık satırı — tıklanabilir olan bu. */
+    summary: ReactNode;
+    /** Başlığın sağında duran ikincil bilgi (süre, sayaç, rozet). */
+    meta?: ReactNode;
+    children: ReactNode;
     /**
-     * Bulunulan adımın DİZİNİ (0 tabanlı). Öncesi tamamlanmış sayılır.
-     * VERİLMEZSE liste ilerleme değil SIRALI TALİMAT olarak çizilir: durum
-     * metni yok, tik yok, `aria-current` yok — yalnızca numaralı adımlar
-     * ("olası nedenler — kontrol sırasıyla" gibi teşhis listeleri).
+     * Kontrollü kullanım; `onOpenChange` ile birlikte verilir.
+     * ⚠ Ebeveyn `onOpenChange`i yok sayarsa DOM bir sonraki render'da prop'a döner, AYNI tuş vuruşunda
+     * değil: `toggle` olayı eşzamansız ve anında geri çevirmek kendi `toggle`ıyla yarışıyordu.
      */
+    isOpen?: boolean;
+    /** Kontrolsüz kullanımda açılış durumu (boolean prop adı `is*` — API kuralı). */
+    isDefaultOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    isDisabled?: boolean;
+    /** `framed` kendi kenarlığı ve zemini olan kutu; `plain` kenarlıksız satır (liste içinde). */
+    variant?: DisclosureVariant;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_42 = {
+    steps: StepItem[];
+    /** Bulunulan adımın DİZİNİ (0 tabanlı). */
     currentIndex?: number;
-    /**
-     * Bir adıma dönülebiliyorsa verilir. Verilmediğinde adımlar düğme DEĞİL
-     * düz metin olur — tıklanabilir görünüp hiçbir şey yapmayan bir adım,
-     * kullanıcıya var olmayan bir yol vaat ediyordu.
-     */
+    /** Bir adıma dönülebiliyorsa verilir. */
     onStepClick?: (index: number) => void;
-    /** Akışın erişilebilir adı ("Ödeme adımları"). ZORUNLU. */
+    /** Akışın erişilebilir adı ("Ödeme adımları"). */
     label: string;
     orientation?: 'horizontal' | 'vertical';
     className?: string;
     testId?: string;
 };
 
-declare type Props_39 = {
+declare type Props_43 = {
     items: TabItem[];
     /** Kontrolsüz kullanımda açılışta seçili sekme. */
     defaultTabId?: string;
@@ -1926,19 +1902,7 @@ declare type Props_39 = {
     testId?: string;
 };
 
-declare type Props_4 = {
-    /** Tetikleyici. TEK öğe; bileşen ona `ref` ve ARIA ekliyor. */
-    trigger: ReactElement;
-    items: MenuItem[];
-    /** Menünün erişilebilir adı ("Satır eylemleri"). ZORUNLU. */
-    label: string;
-    side?: PositionSide;
-    align?: PositionAlign;
-    className?: string;
-    testId?: string;
-};
-
-declare type Props_40 = {
+declare type Props_44 = {
     label: string;
     /** İkon DIŞARIDAN gelir: hangi ikonun hangi konuya ait olduğu uygulamanın bilgisi. */
     icon: ReactNode;
@@ -1952,34 +1916,34 @@ declare type Props_40 = {
     testId?: string;
 };
 
-declare type Props_41 = {
+declare type Props_45 = {
     events: TimelineEvent[];
-    /** Akışın erişilebilir adı ("Sipariş geçmişi"). ZORUNLU. */
+    /** Akışın erişilebilir adı ("Sipariş geçmişi"). */
     label: string;
     className?: string;
     testId?: string;
 };
 
-declare type Props_42 = {
+declare type Props_46 = {
     title: string;
-    /** Kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    /** Kapatma düğmesinin erişilebilir adı. */
     closeLabel?: string;
     onClose: () => void;
     children: ReactNode;
     /**
-     * Başlığın altında duran, gövde kaydırılırken yerinde kalan şerit —
-     * `Combobox`ın arama kutusu gibi.
+     * Başlığın altında duran, gövde kaydırılırken yerinde kalan şerit — `Combobox`ın arama kutusu
+     * gibi.
      */
     toolbar?: ReactNode;
     /** Dipte duran eylem şeridi. */
     footer?: ReactNode;
-    /** Panelin <strong>kendiliğinden kapandığı</strong> medya sorgusu. */
+    /** Panelin kendiliğinden kapandığı medya sorgusu. */
     closeAbove?: string;
     className?: string;
     testId?: string;
 };
 
-declare type Props_43 = {
+declare type Props_47 = {
     isOpen: boolean;
     onClose: () => void;
     title: string;
@@ -1988,42 +1952,50 @@ declare type Props_43 = {
     children?: ReactNode;
     /** 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. */
+    /** Altta duran eylemler. */
     footer?: ReactNode;
     /** Başlığın solunda duran ikon madalyonu; `tone` rengini alır. */
     icon?: ReactNode;
     /** İkon madalyonunun tonu. */
     tone?: ModalTone;
-    size?: 'sm' | 'md' | 'lg';
+    /** `xl` (≈1040 px) sekmeli, tablolu panolar için; dar ekranda diğerleri gibi tam genişlik. */
+    size?: 'sm' | 'md' | 'lg' | 'xl';
     /** `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz. */
     isDismissable?: boolean;
     className?: string;
     testId?: string;
 };
 
-declare type Props_44 = {
+declare type Props_48 = {
     isOpen: boolean;
     onClose: () => void;
     items: CommandItem[];
-    /** Pencerenin erişilebilir adı ("Komut paleti"). ZORUNLU. */
+    /** Pencerenin erişilebilir adı ("Komut paleti"). */
     label: string;
-    /** Arama kutusunun yer tutucusu ve erişilebilir adı. ZORUNLU. */
+    /** Arama kutusunun yer tutucusu ve erişilebilir adı. */
     searchPlaceholder: string;
-    /** Sonuç yokken yazılan metin. ZORUNLU. */
+    /** Sonuç yokken yazılan metin. */
     emptyMessage: string;
+    /**
+     * Paleti açıp kapatan kısayol: `'mod+k'` (`mod` macOS'ta ⌘, diğerlerinde Ctrl), `'shift+/'`.
+     * Başka bir kipsel yüzey açıkken yok sayılır. `onOpen` ile birlikte verilir.
+     */
+    hotkey?: string;
+    /** Kısayol basıldığında, palet kapalıyken. */
+    onOpen?: () => void;
     className?: string;
     testId?: string;
 };
 
-declare type Props_45 = {
+declare type Props_49 = {
     isOpen: boolean;
     onClose: () => void;
     /**
-     * Onaylandığında çalışır. `Promise` dönerse düğme beklerken yükleme
-     * durumuna geçer ve pencere <strong>kapanmaz</strong>.
+     * Onaylandığında çalışır. `Promise` dönerse düğme beklerken yükleme durumuna geçer ve pencere
+     * kapanmaz.
      */
     onConfirm: () => void | Promise<void>;
-    /** Soru cümlesi. Eylem odaklı yazılır: "…silinsin mi?". */
+    /** Soru cümlesi. */
     title: string;
     /** Sonucu açıklar: neyin geri alınamaz olduğu burada yazılır. */
     description?: ReactNode;
@@ -2035,20 +2007,32 @@ declare type Props_45 = {
     closeLabel?: string;
     /** 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. */
+    /** @deprecated `variant` kullanın. */
     kind?: ConfirmKind;
     /** Ek bağlam: silinecek kaydın özeti, uyarı kutusu. */
     children?: ReactNode;
 };
 
-declare type Props_46 = {
+declare type Props_5 = {
+    /** Tetikleyici. */
+    trigger: ReactElement;
+    items: MenuItem[];
+    /** Menünün erişilebilir adı ("Satır eylemleri"). */
+    label: string;
+    side?: PositionSide;
+    align?: PositionAlign;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_50 = {
     isOpen: boolean;
     onClose: () => void;
     title: string;
-    /** Kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    /** Kapatma düğmesinin erişilebilir adı. */
     closeLabel?: string;
     children: ReactNode;
-    /** Panelin hangi kenardan geldiği. Mantıksal: `end` RTL'de sola açılır. */
+    /** Panelin hangi kenardan geldiği. */
     side?: 'start' | 'end';
     size?: 'sm' | 'md' | 'lg';
     /** Dipte duran eylem şeridi; gövde kaydırılırken yerinde kalır. */
@@ -2059,67 +2043,45 @@ declare type Props_46 = {
     testId?: string;
 };
 
-declare type Props_47 = BaseProps_3 & {
+declare type Props_51 = 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)"). */
     requiredLabel?: string;
 };
 
-declare type Props_48 = TableHTMLAttributes<HTMLTableElement> & Partial<{
-    /**
-     * Hücre dolgusu. Tablolar aynı iskeleti paylaşır ama yoğunlukları içeriğe
-     * göre değişir: yüzlerce satırlık bir liste sıkı, karşılaştırma matrisi
-     * ferah durur.
-     */
+declare type Props_52 = TableHTMLAttributes<HTMLTableElement> & Partial<{
+    /** Hücre dolgusu. */
     density: 'compact' | 'regular' | 'spacious';
-    /**
-     * Başlık satırı `$surface-2` zeminle kutunun içinde YAPIŞKAN kalır.
-     * Zemin zorunlu: saydam başlığın arkasından kayan satırlar geçiyordu.
-     * `top: 0` doğru olan — referans üst bant değil, tablonun kendi kaydırma
-     * kutusu.
-     */
+    /** Başlık satırı `$surface-2` zeminle kutunun içinde YAPIŞKAN kalır. */
     hasStickyHead: boolean;
     /** Satır hover zemini: çok sütunlu tabloda göz satırını kaybediyor. */
     hasRowHover: boolean;
 }>;
 
-declare type Props_49 = {
+declare type Props_53 = {
     columns: DataTableColumn[];
     /**
      * Tablonun erişilebilir adı ("Bekleyen siparişler").
-     *
-     * ⚠ ADSIZ TABLO EKRAN OKUYUCUDA YALNIZCA "tablo" DİYE OKUNUR. Panelde
-     * aynı anda birden fazla tablo bulunabiliyor ve kullanıcı hangisinde
-     * olduğunu ayırt edemiyordu. `<caption>` yerine `aria-label` seçildi:
-     * başlık zaten `PageHeader`/`Panel` içinde görünür durumda, ikinci kez
-     * çizmek görsel tekrar olurdu.
+     * ⚠ ADSIZ TABLO EKRAN OKUYUCUDA YALNIZCA "tablo" DİYE OKUNUR.
      */
     label?: string;
     /**
-     * Gövde satırları (`<tr>`). Ekranların özel hücreleri, bağlantıları ve satır
-     * tintleri burada yaşar; tablo yalnızca kabuğu ve durum satırlarını
-     * üstlenir. Uyarı tinti için {@link DataTableRow}.
+     * Gövde satırları (` `). Ekranların özel hücreleri, bağlantıları ve satır tintleri burada yaşar;
+     * tablo yalnızca kabuğu ve durum satırlarını üstlenir.
      */
     children?: ReactNode;
-    /** Satır yokken gösterilen metin. Verilmezse `labels.dataTable.empty`. */
+    /** Satır yokken gösterilen metin. */
     emptyMessage?: string;
-    /** Yükleme sürerken gösterilen metin. Verilmezse `labels.dataTable.loading`. */
+    /** Yükleme sürerken gösterilen metin. */
     loadingMessage?: string;
     isLoading?: boolean;
     /**
-     * Liste ÇEKİLEMEDİ. <strong>"Yüklenemedi" ile "boş" ayrı durumlardır</strong>:
-     * hata verilmişken boş mesajı asla çizilmez — ağ hatasını "kayıt kalmamış"
-     * diye okutmak kullanıcıya yanlış karar verdirir. Hatayı tablonun dışında
-     * (`Alert`) gösteren ekran bu prop'u geçmez.
+     * Liste ÇEKİLEMEDİ. "Yüklenemedi" ile "boş" ayrı durumlardır: hata verilmişken boş mesajı asla
+     * çizilmez
      */
     error?: string | null;
-    /**
-     * Gövde `100dvh - <bant>` ile sınırlanır ve başlık satırı kendi kaydırma
-     * alanına yapışır. Sınırsız yükseklikte `position: sticky` HİÇ çalışmıyordu:
-     * `overflow` alanı ekrandan uzun olunca başlık sayfayla birlikte yukarı çıkıp
-     * gidiyordu.
-     */
+    /** Gövde `100dvh - <bant>` ile sınırlanır ve başlık satırı kendi kaydırma alanına yapışır. */
     hasViewportCap?: boolean;
     /** Sıralanabilir bir başlığa basıldığında çağrılır. */
     onSort?: (key: string, direction: 'ascending' | 'descending') => void;
@@ -2129,49 +2091,46 @@ declare type Props_49 = {
     testId?: string;
 };
 
-declare type Props_5 = {
+declare type Props_54 = {
     /**
-     * Tetikleyici. TEK bir öğe olmak zorunda: bileşen ona `ref`, `onClick` ve
-     * `aria-expanded` ekliyor.
+     * Filtreler uygulanır. `preventDefault` bileşenin işi; çağıran yalnızca durumunu günceller
+     * (sayfayı 1'e almak + aramayı uygulamak gibi).
      */
+    onSubmit: () => void;
+    /** Alanlar — her biri FilterBarField içinde. */
+    children: ReactNode;
+    /** Şeridin sağ ucundaki eylemler ("Uygula" düğmesi gibi). */
+    actions?: ReactNode;
+    /** Şeridin erişilebilir adı. */
+    label?: string;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_55 = LinkProps | ButtonProps;
+
+declare type Props_6 = {
+    /** Tetikleyici. */
     trigger: ReactElement;
     children: ReactNode;
-    /** Yüzeyin erişilebilir adı. ZORUNLU — adsız bir bölge "grup" diye okunur. */
+    /** Yüzeyin erişilebilir adı. */
     label: string;
     side?: PositionSide;
     align?: PositionAlign;
-    /** Kontrollü kullanım. Verilmezse bileşen durumu kendisi tutar. */
+    /** Kontrollü kullanım. */
     isOpen?: boolean;
     onOpenChange?: (isOpen: boolean) => void;
     className?: string;
     testId?: string;
 };
 
-declare type Props_50 = {
-    /**
-     * Filtreler uygulanır. `preventDefault` bileşenin işi; çağıran yalnızca
-     * durumunu günceller (sayfayı 1'e almak + aramayı uygulamak gibi).
-     */
-    onSubmit: () => void;
-    /** Alanlar — her biri {@link FilterBarField} içinde. */
-    children: ReactNode;
-    /** Şeridin sağ ucundaki eylemler ("Uygula" düğmesi gibi). */
-    actions?: ReactNode;
-    /** Şeridin erişilebilir adı. Verilmezse `labels.filters`. */
-    label?: string;
-    className?: string;
-    testId?: string;
-};
-
-declare type Props_51 = LinkProps | ButtonProps;
+declare type Props_7<T extends string> = SingleProps<T> | MultipleProps<T>;
 
-declare type Props_6<T extends string> = SingleProps<T> | MultipleProps<T>;
-
-declare type Props_7<T extends string> = {
+declare type Props_8<T extends string> = {
     options: SegmentOption<T>[];
     value: T;
     onChange: (value: T) => void;
-    /** Grubun erişilebilir adı ("Görünüm"). ZORUNLU. */
+    /** Grubun erişilebilir adı ("Görünüm"). */
     label: string;
     /** Etiketler gizlenir, yalnızca ikon çizilir. `label` yine okunur. */
     isIconOnly?: boolean;
@@ -2180,18 +2139,15 @@ declare type Props_7<T extends string> = {
     testId?: string;
 };
 
-declare type Props_8<T extends string> = {
+declare type Props_9<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.
-     */
+    /** Alanın adı. */
     label: string;
-    /** Seçim yokken tetikleyicide görünen metin. Verilmezse `labels.selectPlaceholder`. */
+    /** Seçim yokken tetikleyicide görünen metin. */
     placeholder?: string;
-    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. */
     closeLabel?: string;
     /** Tetikleyicinin solundaki ikon. */
     icon?: ReactNode;
@@ -2203,14 +2159,8 @@ declare type Props_8<T extends string> = {
     id?: string;
     /**
      * Zorunluluk — `Field`in `FieldChildProps` sözleşmesinden gelir.
-     *
-     * ⚠ Bileşen `...rest` YAYMIYOR, yani `Props`ta bildirilmeyen her alan
-     * sessizce buharlaşır. `required` bir dönem tam olarak öyleydi: `<Field
-     * isRequired>{props => <Select {...props} …/>}</Field>` yazan çağıran
-     * görsel `*` ve sr-only "(zorunlu)" alıyor ama KONTROLDE hiçbir işaret
-     * olmuyordu — doğrudan kutuya atlayan ekran okuyucu kullanıcısı alanın
-     * zorunlu olduğunu hiç duymuyordu. `props` taze bir nesne literali olmadığı
-     * için TypeScript'in fazla-özellik denetimi de uyarmıyordu.
+     * ⚠ Bileşen `...rest` YAYMIYOR, yani `Props`ta bildirilmeyen her alan sessizce buharlaşır.
+     * `required` bir dönem tam olarak öyleydi: `<Field…
      */
     required?: boolean;
     'aria-describedby'?: string;
@@ -2219,21 +2169,10 @@ declare type Props_8<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. */
-declare const QuantityStepper_2: FC<Props_12>;
+declare const QuantityStepper_2: FC<Props_13>;
 
 export declare const Radio: typeof Radio_2;
 
@@ -2250,16 +2189,16 @@ testId?: string;
 export declare const RadioCard: typeof RadioCard_2;
 
 /** Seçilebilir kart — zengin gövdeli radyo. */
-declare const RadioCard_2: FC<Props_9>;
+declare const RadioCard_2: FC<Props_10>;
 
 declare type RangeProps = {
     value: DateRangeValue;
     onChange: (value: DateRangeValue) => void;
-    /** Başlangıç alanının erişilebilir adı ("Başlangıç"). ZORUNLU. */
+    /** Başlangıç alanının erişilebilir adı ("Başlangıç"). */
     startLabel: string;
-    /** Bitiş alanının erişilebilir adı ("Bitiş"). ZORUNLU. */
+    /** Bitiş alanının erişilebilir adı ("Bitiş"). */
     endLabel: string;
-    /** İki alanın arasındaki ayraç. Varsayılan yarım tire. */
+    /** İki alanın arasındaki ayraç. */
     separator?: string;
     /** Ölçeğin uçları; ikisi de yerel öğeye geçer. */
     min?: string;
@@ -2274,19 +2213,19 @@ declare type RangeProps = {
 export declare const RangeSlider: typeof RangeSlider_2;
 
 /** Ç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;
+declare const RangeSlider_2: ({ min, max, step, value, onChange, onCommit, formatValue, label, minLabel, maxLabel, isDisabled, className, testId, }: Props_11) => JSX.Element;
 
 export declare type RangeValue = [number, number];
 
 export declare const Rating: typeof Rating_2;
 
 /** Yıldız puanı — salt gösterim. */
-declare const Rating_2: FC<Props_29>;
+declare const Rating_2: FC<Props_32>;
 
 export declare const RatingInput: typeof RatingInput_2;
 
 /** Yıldızla puan girişi. */
-declare const RatingInput_2: ({ value, onChange, label, ratingLabels, formatStarCount, isDisabled, className, testId, }: Props_11) => JSX.Element;
+declare const RatingInput_2: ({ value, onChange, label, ratingLabels, formatStarCount, isDisabled, className, testId, }: Props_12) => JSX.Element;
 
 /** Beş puanın her birinin ne anlama geldiği. */
 export declare type RatingLabels = Record<1 | 2 | 3 | 4 | 5, string>;
@@ -2302,22 +2241,16 @@ declare type RowProps = HTMLAttributes<HTMLTableRowElement> & {
 
 export declare const ScrollArea: typeof ScrollArea_2;
 
-/** Kaydırma kutusu — <strong>klavyeyle erişilebilir</strong> kaydırma bölgesi. */
-declare const ScrollArea_2: FC<Props_31>;
+/** Kaydırma kutusu — klavyeyle erişilebilir kaydırma bölgesi. */
+declare const ScrollArea_2: FC<Props_34>;
 
 declare type ScrollerProps = HTMLAttributes<HTMLDivElement> & {
-    /**
-     * Çerçeve (hairline + yarıçap + yüzey). Gömülü tablolarda kapatılır: orada
-     * tablo zaten bir kartın içinde ve ikinci bir çerçeve kutu içinde kutu
-     * görünüyordu.
-     */
+    /** Çerçeve (hairline + yarıçap + yüzey). */
     hasFrame?: boolean;
     /**
      * Kaydırma bölgesinin erişilebilir adı ("Sipariş kalemleri").
-     *
-     * ⚠ ZORUNLU değil ama VERİLMELİ: kutu klavyeyle odaklanabilir bir
-     * `region` ve adsız bir bölge ekran okuyucuda yalnızca "bölge" diye
-     * okunur — kullanıcı neyin içinde olduğunu bilemez.
+     * ⚠ ZORUNLU değil ama VERİLMELİ: kutu klavyeyle odaklanabilir bir `region` ve adsız bir bölge
+     * ekran okuyucuda yalnızca "bölge" diye okunur
      */
     label?: string;
 };
@@ -2325,12 +2258,12 @@ declare type ScrollerProps = HTMLAttributes<HTMLDivElement> & {
 export declare const SectionHeader: typeof SectionHeader_2;
 
 /** Bölüm başlığı. */
-declare const SectionHeader_2: FC<Props_30>;
+declare const SectionHeader_2: FC<Props_33>;
 
 export declare const SegmentedControl: typeof SegmentedControl_2;
 
-/** 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;
+/** Bölmeli denetim — görünüm değiştirme. */
+declare const SegmentedControl_2: <T extends string>({ options, value, onChange, label, isIconOnly, size, className, testId, }: Props_8<T>) => JSX.Element;
 
 export declare type SegmentOption<T extends string = string> = {
     value: T;
@@ -2343,7 +2276,7 @@ export declare type SegmentOption<T extends string = string> = {
 export declare const Select: typeof Select_2;
 
 /** Seçim kutusu. */
-declare const Select_2: <T extends string>({ options, value, onChange, label, placeholder, closeLabel, icon, size, align, isDisabled, id, className, testId, required, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_8<T>) => JSX.Element;
+declare const Select_2: <T extends string>({ options, value, onChange, label, placeholder, closeLabel, icon, size, align, isDisabled, id, className, testId, required, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_9<T>) => JSX.Element;
 
 export declare type SelectOption<T extends string = string> = {
     value: T;
@@ -2367,7 +2300,7 @@ declare type SingleProps<T extends string> = BaseProps<T> & {
 export declare const Skeleton: typeof Skeleton_2;
 
 /** Yükleme iskeleti. */
-declare const Skeleton_2: FC<Props_32>;
+declare const Skeleton_2: FC<Props_35>;
 
 export declare const SkeletonCard: NamedExoticComponent<ShapeProps>;
 
@@ -2380,16 +2313,28 @@ columns?: number;
 export declare const Spinner: typeof Spinner_2;
 
 /** Yükleme göstergesi. */
-declare const Spinner_2: FC<Props_36>;
+declare const Spinner_2: FC<Props_39>;
 
 export declare const Stat: typeof Stat_2;
 
 /** Ölçüm kutusu (KPI). */
-declare const Stat_2: FC<Props_33>;
+declare const Stat_2: FC<Props_36>;
 
 /** Değişimin yönü. `flat` "değişmedi" — yokluk DEĞİL. */
 export declare type StatTrend = 'up' | 'down' | 'flat';
 
+export declare const StatusDot: typeof StatusDot_2;
+
+/**
+ * Durum noktası — bağlantı, araç çağrısı, meşguliyet.
+ *
+ * ⚠ Marka tonu YOK (`brand`): nokta bir durum taşır, marka yüzeyi değil. Süren iş `neutral` +
+ * `isPulsing` ile anlatılır; yeşil yalnızca anlamsal başarıda (`success`).
+ */
+declare const StatusDot_2: FC<Props_25>;
+
+export declare type StatusDotTone = 'neutral' | 'success' | 'warning' | 'danger';
+
 export declare type StepItem = {
     id: string;
     label: string;
@@ -2400,33 +2345,27 @@ export declare type StepItem = {
 export declare const Steps: typeof Steps_2;
 
 /** Adım göstergesi (stepper) — çok adımlı akışta NEREDE olunduğu. */
-declare const Steps_2: FC<Props_38>;
+declare const Steps_2: FC<Props_42>;
+
+declare type StickToBottom = {
+    /** Kutu sonda mı (pay dahilinde). `false` iken "en yeniye in" düğmesi gösterilir. */
+    isAtEnd: boolean;
+    /** Sona kaydırır ve yeniden yapışır. */
+    scrollToEnd: () => void;
+};
 
 export declare const SummaryCard: typeof SummaryCard_2;
 
-/**
- * Özet kartı — başlık + kısa açıklama + meta satırı taşıyan BAĞLANTILI kart.
- *
- * Kartın tamamı tıklanır ama sekme durağı TEKTİR: bağlantı başlıktadır,
- * yüzeyi `::after` katmanı kaplar. `meta` satırı katmanın ÜSTÜNDE durur —
- * içine konan çip/rozet tıklamaları kart bağlantısına düşmez.
- */
-declare const SummaryCard_2: FC<Props_34>;
+/** Özet kartı — başlık + kısa açıklama + meta satırı taşıyan BAĞLANTILI kart. */
+declare const SummaryCard_2: FC<Props_37>;
 
 export declare type SummaryCardHeadingLevel = 2 | 3 | 4;
 
 export declare const Switch: typeof Switch_2;
 
 /**
- * Anahtar (switch) — <strong>anında</strong> uygulanan aç/kapa.
- *
- * @example
- * <Switch
- * label="Kampanya bildirimleri"
- * hint="E-posta ile ayda en fazla iki ileti"
- * checked={isSubscribed}
- * onChange={event => subscribe(event.target.checked)}
- * />
+ * Anahtar (switch) — anında uygulanan aç/kapa.
+ * @example <Switch label="Kampanya bildirimleri" hint="E-posta ile ayda en fazla iki…
  */
 declare const Switch_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "role" | "type"> & {
 /** Anahtarın görünür etiketi. */
@@ -2450,34 +2389,26 @@ export declare type TabItem = {
 export declare const Table: typeof Table_2;
 
 /** Temel tablo — hairline satır ayrımı, `$surface-2` başlık, yoğunluk ölçeği. */
-declare const Table_2: FC<Props_48>;
+declare const Table_2: FC<Props_52>;
 
 export declare const TableCheckbox: typeof TableCheckbox_2;
 
 /** 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
-* başlığında); adsız kutu ekran okuyucuda yalnızca "onay kutusu" diye
-* okunur. Satır kutusunda kaydın kimliğini söyleyin ("SP-2026-000123 seç").
-*/
+/** Erişilebilir ad — ZORUNLU. */
 label: string;
 /**
 * "Bazı satırlar seçili" — başlık kutusunun üçüncü durumu.
-*
-* ⚠ Bu prop OLMADAN o durum İFADE EDİLEMİYORDU. `indeterminate` bir HTML
-* niteliği değil, yalnızca DOM ÖZELLİĞİ; JSX ile yazılamaz, `ref` üzerinden
-* atanması gerekir. Sonuç: başlık kutusu ya "hiçbiri" ya "hepsi" diyordu,
-* kısmi seçimde ise sessizce YANLIŞ bilgi veriyordu — operatör "hepsi
-* seçili" sanıp toplu işlem yapıyordu.
+* ⚠ Bu prop OLMADAN o durum İFADE EDİLEMİYORDU. `indeterminate` bir HTML niteliği değil, yalnızca
+* DOM ÖZELLİĞİ
 */
 isIndeterminate?: boolean;
 testId?: string;
 } & RefAttributes<HTMLInputElement>>;
 
 /**
- * Tablo kaydırma kutusu — "tablo kendi kutusunda kayar, sayfa asla yatay
- * kaymaz" kuralının tek uygulaması.
+ * Tablo kaydırma kutusu — "tablo kendi kutusunda kayar, sayfa asla yatay kaymaz" kuralının tek
+ * uygulaması.
  */
 export declare const TableScroller: FC<ScrollerProps>;
 
@@ -2488,17 +2419,18 @@ export declare const TABLET_PORTRAIT_BREAKPOINT = 768;
 export declare const Tabs: typeof Tabs_2;
 
 /** Sekmeler. */
-declare const Tabs_2: FC<Props_39>;
+declare const Tabs_2: FC<Props_43>;
 
 export declare const TagInput: typeof TagInput_2;
 
 /** Etiket girdisi — yazılan metni kaldırılabilir çiplere çevirir. */
-declare const TagInput_2: ({ values, onChange, label, placeholder, removeLabel, separators, maxTags, isDisabled, id, required, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_14) => JSX.Element;
+declare const TagInput_2: ({ values, onChange, label, placeholder, removeLabel, separators, maxTags, isDisabled, id, required, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_15) => JSX.Element;
 
 export declare const Textarea: typeof Textarea_2;
 
 /** Çok satırlı metin girdisi. */
 declare const Textarea_2: ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & {
+variant?: TextareaVariant;
 /** Alan içeriğiyle birlikte BÜYÜR — kaydırma çubuğu yerine yükseklik. */
 isAutoSize?: boolean;
 /** Otomatik büyümenin tavanı (satır). */
@@ -2508,10 +2440,17 @@ hasCounter?: boolean;
 testId?: string;
 } & RefAttributes<HTMLTextAreaElement>>;
 
+/**
+ * `bare`: kenarlık, zemin, dolgu ve gölge YOK — çerçeveyi kapsayıcı çizer (sohbet girdisi).
+ * ⚠ Odak göstergesi de kapsayıcının işi (`:focus-within`); `bare` alanı çerçevesiz bir kutuya
+ * konursa odak görünmez olur.
+ */
+declare type TextareaVariant = 'default' | 'bare';
+
 export declare const TextLink: typeof TextLink_2;
 
 /** Metin bağlantısı. */
-declare const TextLink_2: ({ href, children, hasArrow, tone, size, className, linkProps, ...rest }: Props_2) => JSX.Element;
+declare const TextLink_2: ({ href, children, hasArrow, tone, size, className, linkProps, ...rest }: Props_3) => JSX.Element;
 
 /** Temanın taşındığı öznitelik. `<html data-hanui-theme="dark">`. */
 export declare const THEME_ATTRIBUTE = "data-hanui-theme";
@@ -2519,17 +2458,17 @@ export declare const THEME_ATTRIBUTE = "data-hanui-theme";
 export declare const Tile: typeof Tile_2;
 
 /** Karo — ikon madalyonu + etiket. */
-declare const Tile_2: ({ label, icon, href, meta, isActive, linkProps, className, testId }: Props_40) => JSX.Element;
+declare const Tile_2: ({ label, icon, href, meta, isActive, linkProps, className, testId }: Props_44) => JSX.Element;
 
 export declare const Timeline: typeof Timeline_2;
 
 /** Zaman çizelgesi — sipariş durumu, işlem geçmişi. */
-declare const Timeline_2: FC<Props_41>;
+declare const Timeline_2: FC<Props_45>;
 
 export declare type TimelineEvent = {
     id: string;
     title: string;
-    /** Zaman damgası — BİÇİMLENDİRİLMİŞ dize. Bileşen tarih biçimlendirmez. */
+    /** Zaman damgası — BİÇİMLENDİRİLMİŞ dize. */
     time?: string;
     description?: ReactNode;
     status?: TimelineStatus;
@@ -2542,10 +2481,7 @@ export declare type TimelineStatus = 'done' | 'current' | 'pending' | 'failed';
 
 /**
  * BİLDİRİM SÖZLEŞMESİ — süre, ikon ve renk kararları TEK YERDE.
- *
- * @example
- * toast.success('Adres kaydedildi');
- * toast.error('Kart reddedildi', { action: { label: 'Yeniden dene', onClick: retry } });
+ * @example toast.success('Adres kaydedildi'); toast.error('Kart reddedildi', { action: { label…
  */
 export declare const toast: {
     show: (message: string, options?: ToastOptions) => number;
@@ -2560,7 +2496,7 @@ export declare const toast: {
 
 export declare const ToastHub: typeof ToastHub_2;
 
-/** Bildirim yığını — uygulamada <strong>BİR KEZ</strong> çizilir. */
+/** Bildirim yığını — uygulamada BİR KEZ çizilir. */
 declare const ToastHub_2: ({ closeLabel, regionLabel, className }: HubProps) => ReactPortal | null;
 
 export declare type ToastOptions = {
@@ -2580,12 +2516,7 @@ export declare const ToastPortal: typeof ToastPortal_2;
 
 /**
  * `ToastHub`ı montajdan SONRA çizen sarmalayıcı.
- *
- * ⚠ 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.
+ * ⚠ SUNUCUDA ÇİZİLMEMESİ ŞART. `ToastHub` portal kullanıyor ve `document` olmadan çalışamaz
  */
 declare const ToastPortal_2: FC;
 
@@ -2594,10 +2525,12 @@ 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;
+declare const Tooltip_2: ({ content, children, side, position, openDelay, className, }: Props_4) => JSX.Element;
 
 /** Ölçü basamakları. */
 export declare enum UISize {
+    /** Görsel 30 px — yoğun araç çubuğu ve üst bant. Dokunma hedefi yine 44 px (`tap-target`). */
+    XSMALL = "XSMALL",
     SMALL = "SMALL",
     MEDIUM = "MEDIUM",
     LARGE = "LARGE"
@@ -2605,16 +2538,13 @@ export declare enum UISize {
 
 /** Düğme ve eylem varyantları. */
 export declare enum UIVariant {
-    /** Ekranın tek beklenen eylemi: <strong>nötr grafit</strong> dolgu. */
+    /** Ekranın tek beklenen eylemi: çam dolgu (koyu temada mint sınırla). Bir ekranda TEK. */
     PRIMARY = "PRIMARY",
-    /** <strong>Dönüşüm eylemi — ve yalnızca o.</strong> */
+    /** Dönüşüm eylemi — ve yalnızca o. */
     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").
-     */
+    /** Mürekkep çerçeveli eylem — teşvik edilen ama birincil olmayan gezinme ("Tümünü gör"). */
     OUTLINE = "OUTLINE",
     /** Vurgu bandı içindeki eylem: bandın kendi yüzey merdivenini kullanır. */
     DARK = "DARK",
@@ -2622,25 +2552,22 @@ export declare enum UIVariant {
     LIGHT = "LIGHT",
     /** Zeminsiz eylem: araç çubuğu ve satır içi ikincil işler. */
     GHOST = "GHOST",
-    /** Yıkıcı eylem: silme onayı. Durum tinti değil, gerçek bir dolgu. */
+    /** Yıkıcı eylem: silme onayı. */
     DANGER = "DANGER"
 }
 
 export declare type UploadFile = {
     id: string;
     name: string;
-    /** Bayt. Ekranda okunur biçime çevrilir. */
+    /** Bayt. */
     size: number;
     /** 0-100. `undefined` → yükleme başlamadı ya da bitti. */
     progress?: number;
-    /** Bu dosyaya ait hata. Satır kırmızı çizilir ve metin okunur. */
+    /** Bu dosyaya ait hata. */
     error?: string;
 };
 
-/**
- * Duyuru fonksiyonu döndürür. Referans SABİT: bağımlılık dizisine güvenle
- * konur, her render'da yeni bir kapanış üretip etkileri tetiklemez.
- */
+/** Duyuru fonksiyonu döndürür. */
 export declare const useAnnounce: () => ((message: string, politeness?: AnnouncePoliteness) => void);
 
 /** Sağlayıcı ZORUNLU DEĞİL. */
@@ -2648,20 +2575,27 @@ export declare const useHanui: () => HanuiContextValue;
 
 /**
  * Açık/koyu seçimini okur ve değiştirir.
- *
- * @example
- * const { scheme, toggle, isReady } = useHanuiTheme();
+ * @example const { scheme, toggle, isReady } = useHanuiTheme();
  */
 export declare const useHanuiTheme: () => HanuiThemeState;
 
+/**
+ * Token'ların ÇÖZÜLMÜŞ değerleri — CSS değişkeni okuyamayan çizim kütüphaneleri için (recharts
+ * `stroke`/`fill` prop'ları `var(--…)` kabul etmiyor).
+ * Tema değiştiğinde (açık seçim, sistem tercihi, `initHanui` ezmesi) yeniden çizer.
+ * ⚠ Sunucu çıktısında ve hidrasyondan önceki ilk karede her değer `currentColor`.
+ * @example const colors = useHanuiTokens(['series-1', 'series-2', 'border']);
+ */
+export declare const useHanuiTokens: <TName extends HanuiToken>(names: readonly TName[]) => Record<TName, string>;
+
 /** 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>;
 
 /**
- * ÇARPIŞMAYA DUYARLI KONUMLANDIRMA — `Tooltip`, `Popover`, `Menu` ve açılır
- * listelerin ortak temeli.
+ * ÇARPIŞMAYA DUYARLI KONUMLANDIRMA — `Tooltip`, `Popover`, `Menu` ve açılır listelerin ortak
+ * temeli.
  */
 export declare const usePositioning: (anchorRef: {
     current: HTMLElement | null;
@@ -2669,6 +2603,16 @@ export declare const usePositioning: (anchorRef: {
     current: HTMLElement | null;
 }, { side, align, offset, padding, isOpen }: PositioningOptions) => PositioningState;
 
+/**
+ * Kaydırma kutusunu SONA yapışık tutar — kullanıcı yukarı kaydırana kadar. Akan bir yanıt, canlı
+ * terminal çıktısı, büyüyen akıl yürütme metni.
+ * İçerik değişimini (`MutationObserver`: yeni satır, akan metin) ve kutunun kendi boyunu
+ * (`ResizeObserver`: ekran klavyesi açılınca) izler; render'da yerleşim okumaz.
+ * @param isEnabled `false` iken hiçbir şey izlenmez.
+ * @example const { isAtEnd, scrollToEnd } = useStickToBottom(listRef);
+ */
+export declare const useStickToBottom: (ref: RefObject<HTMLElement | null>, isEnabled?: boolean) => StickToBottom;
+
 /** SANALLAŞTIRMA — yalnızca görünen satırları çiz. */
 export declare const useVirtualList: (count: number, { rowHeight, overscan, isEnabled }?: {
     rowHeight?: number | undefined;