@ahmetilhn/hanui 4.1.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,7 +45,7 @@ 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';
 
@@ -55,17 +58,25 @@ export declare const applyThemeConfig: (config: HanuiThemeConfig | undefined) =>
 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'
@@ -143,12 +154,12 @@ declare type BaseProps_4 = {
     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;
@@ -162,6 +173,7 @@ export declare const Button: typeof Button_2;
 declare const Button_2: ForwardRefExoticComponent<Partial<{
 variant: UIVariant;
 size: UISize;
+shape: ButtonShape;
 isLoading: boolean;
 isFullWidth: boolean;
 startIcon: ReactNode;
@@ -186,6 +198,9 @@ 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;
 
 /**
@@ -248,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;
 
@@ -288,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;
@@ -309,6 +324,11 @@ declare type CircleProps = {
     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;
@@ -318,10 +338,14 @@ declare type CircleProps = {
 
 export declare const CodeBadge: typeof CodeBadge_2;
 
-/** Teknik kod rozeti — monospace kod, marka zeminli çerçeve. */
-declare const CodeBadge_2: FC<Props_22>;
+/**
+ * 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_23>;
 
-export declare type CodeBadgeSize = 'sm' | 'md' | 'lg';
+export declare type CodeBadgeSize = 'xs' | 'sm' | 'md' | 'lg';
 
 export declare const Combobox: typeof Combobox_2;
 
@@ -395,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<{
@@ -416,14 +440,14 @@ export declare const ConfirmDialog: typeof ConfirmDialog_2;
  * Onay penceresi.
  * @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 — tek dokunuşla panoya. */
-declare const CopyField_2: FC<Props_23>;
+declare const CopyField_2: FC<Props_26>;
 
 export declare type Crumb = {
     label: string;
@@ -437,7 +461,7 @@ 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). */
@@ -540,20 +564,34 @@ 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;
 
@@ -562,7 +600,7 @@ export declare const Field: typeof Field_2;
  * @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 = {
@@ -582,12 +620,12 @@ declare type FieldProps = {
 export declare const FileUpload: typeof FileUpload_2;
 
 /** 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_16) => JSX.Element;
+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. */
 export declare const FilterBarField: FC<FieldProps>;
@@ -690,6 +728,36 @@ 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ı. */
         copy: Formatter<[value: string]>;
@@ -767,7 +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…
+ * @example <HanuiProvider linkComponent={NextLink} theme={{ light: { link: '#0a58ca' } }}> <App…
  */
 export declare const HanuiProvider: FC<Props>;
 
@@ -776,7 +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: {…
+ * @example initHanui({ theme: { light: { link: '#0a58ca', 'ring-color': '#0d6efd' }, dark: {…
  */
 export declare type HanuiThemeConfig = Partial<{
     light: HanuiThemeTokens;
@@ -789,6 +857,20 @@ export declare type HanuiThemeConfig = Partial<{
     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
@@ -811,6 +893,15 @@ 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ı. */
     closeLabel?: string;
@@ -830,9 +921,10 @@ declare const IconButton_2: ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLB
 icon: ReactNode;
 /** Görsel etiketi olmayan düğmenin erişilebilir adı — ZORUNLU. */
 label: string;
-/** `cart` yalnızca dönüşüm eyleminde kullanılır — ekranda görünen tek doygun turuncu odur. */
+/** `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. */
@@ -840,6 +932,9 @@ 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';
 
 /**
@@ -870,60 +965,76 @@ 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. */
-    readonly 'action-soft': "#aaddbf";
+    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";
@@ -932,19 +1043,19 @@ 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";
@@ -963,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}`;
@@ -971,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 & {
@@ -1016,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;
@@ -1080,6 +1198,8 @@ 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 aynı değerler. */
@@ -1088,7 +1208,7 @@ 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';
 
@@ -1104,12 +1224,12 @@ 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;
 
@@ -1117,7 +1237,7 @@ export declare const Panel: typeof Panel_2;
  * Panel — başlığı olan içerik kutusu.
  * @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>;
@@ -1143,12 +1263,12 @@ 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
  */
-declare const PasswordInput_2: FC<Props_13>;
+declare const PasswordInput_2: FC<Props_14>;
 
 export declare const Popover: typeof Popover_2;
 
 /** Popover — eylem taşıyabilen, odaklanabilir yüzey. */
-declare const Popover_2: ({ trigger, children, label, side, align, isOpen: controlledOpen, onOpenChange, className, testId, }: Props_5) => JSX.Element | null;
+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';
@@ -1189,19 +1309,19 @@ 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 — ölçülebilir bekleme. */
-declare const Progress_2: ({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: Props_35) => JSX.Element;
+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;
@@ -1217,6 +1337,17 @@ 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;
@@ -1238,7 +1369,7 @@ declare type Props_10 = {
     testId?: string;
 };
 
-declare type Props_11 = {
+declare type Props_12 = {
     value: number | null;
     onChange: (value: number) => void;
     /** Grubun erişilebilir adı ("Ürün puanı"). */
@@ -1254,7 +1385,7 @@ declare type Props_11 = {
     testId?: string;
 };
 
-declare type Props_12 = {
+declare type Props_13 = {
     value: number;
     onChange: (value: number) => void;
     /** Grubun ve girdinin erişilebilir adı. */
@@ -1271,14 +1402,14 @@ 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ı. */
@@ -1300,13 +1431,13 @@ 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;
@@ -1334,7 +1465,7 @@ declare type Props_16 = {
     testId?: string;
 };
 
-declare type Props_17 = {
+declare type Props_18 = {
     children: ReactNode;
     tone?: AlertTone;
     title?: string;
@@ -1344,11 +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. */
     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';
@@ -1356,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;
@@ -1366,18 +1506,7 @@ 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ı. */
     label?: string;
@@ -1387,7 +1516,7 @@ declare type Props_20 = {
     testId?: string;
 };
 
-declare type Props_21 = {
+declare type Props_22 = {
     children: ReactNode;
     /** Şeridin erişilebilir adı ("Öne çıkan ürünler"). */
     label: string;
@@ -1407,7 +1536,7 @@ declare type Props_21 = {
     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. */
@@ -1419,11 +1548,39 @@ declare type Props_22 = {
     /** `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ı. */
@@ -1439,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;
@@ -1460,7 +1617,7 @@ 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;
@@ -1480,7 +1637,18 @@ declare type Props_26 = {
     testId?: string;
 };
 
-declare type Props_27 = {
+declare type Props_3 = 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_30 = {
     children: ReactNode;
     /** Panel başlığı. */
     title?: string;
@@ -1502,7 +1670,7 @@ declare type Props_27 = {
     testId?: string;
 };
 
-declare type Props_28 = {
+declare type Props_31 = {
     /** BİÇİMLENMİŞ tutar: "1.299,90". */
     value: string;
     /** Para birimi simgesi ya da kodu. */
@@ -1520,7 +1688,7 @@ declare type Props_28 = {
     testId?: string;
 };
 
-declare type Props_29 = {
+declare type Props_32 = {
     /** 0–5 arası puan. */
     value: number;
     /** Değerlendirme sayısı; verilirse yıldızların yanında gösterilir. */
@@ -1532,25 +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. */
-    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_30 = {
+declare type Props_33 = {
     title: string;
     description?: string;
     /** Üstte gösterilen küçük büyük-harf etiket. */
@@ -1563,7 +1713,7 @@ declare type Props_30 = {
     testId?: string;
 };
 
-declare type Props_31 = {
+declare type Props_34 = {
     children: ReactNode;
     /** Kaydırılabilir bölgenin erişilebilir adı. */
     label: string;
@@ -1573,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;
@@ -1588,7 +1743,7 @@ 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. */
@@ -1605,14 +1760,18 @@ declare type Props_33 = {
     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. */
-    variant?: 'card' | 'plain';
+    /**
+     * `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' | '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;
@@ -1630,7 +1789,7 @@ 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.
      */
@@ -1643,20 +1802,44 @@ declare type Props_35 = {
     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;
@@ -1669,7 +1852,29 @@ declare type Props_37 = {
     testId?: string;
 };
 
-declare type Props_38 = {
+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;
+    /**
+     * 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;
@@ -1682,7 +1887,7 @@ declare type Props_38 = {
     testId?: string;
 };
 
-declare type Props_39 = {
+declare type Props_43 = {
     items: TabItem[];
     /** Kontrolsüz kullanımda açılışta seçili sekme. */
     defaultTabId?: string;
@@ -1697,19 +1902,7 @@ declare type Props_39 = {
     testId?: string;
 };
 
-declare type Props_4 = {
-    /** 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_40 = {
+declare type Props_44 = {
     label: string;
     /** İkon DIŞARIDAN gelir: hangi ikonun hangi konuya ait olduğu uygulamanın bilgisi. */
     icon: ReactNode;
@@ -1723,7 +1916,7 @@ 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"). */
     label: string;
@@ -1731,7 +1924,7 @@ declare type Props_41 = {
     testId?: string;
 };
 
-declare type Props_42 = {
+declare type Props_46 = {
     title: string;
     /** Kapatma düğmesinin erişilebilir adı. */
     closeLabel?: string;
@@ -1750,7 +1943,7 @@ declare type Props_42 = {
     testId?: string;
 };
 
-declare type Props_43 = {
+declare type Props_47 = {
     isOpen: boolean;
     onClose: () => void;
     title: string;
@@ -1765,14 +1958,15 @@ declare type Props_43 = {
     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[];
@@ -1782,11 +1976,18 @@ declare type Props_44 = {
     searchPlaceholder: string;
     /** 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;
     /**
@@ -1812,7 +2013,19 @@ declare type Props_45 = {
     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;
@@ -1830,14 +2043,14 @@ 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<{
+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. */
@@ -1846,7 +2059,7 @@ declare type Props_48 = TableHTMLAttributes<HTMLTableElement> & Partial<{
     hasRowHover: boolean;
 }>;
 
-declare type Props_49 = {
+declare type Props_53 = {
     columns: DataTableColumn[];
     /**
      * Tablonun erişilebilir adı ("Bekleyen siparişler").
@@ -1878,22 +2091,7 @@ declare type Props_49 = {
     testId?: string;
 };
 
-declare type Props_5 = {
-    /** Tetikleyici. */
-    trigger: ReactElement;
-    children: ReactNode;
-    /** Yüzeyin erişilebilir adı. */
-    label: string;
-    side?: PositionSide;
-    align?: PositionAlign;
-    /** Kontrollü kullanım. */
-    isOpen?: boolean;
-    onOpenChange?: (isOpen: boolean) => void;
-    className?: string;
-    testId?: string;
-};
-
-declare type Props_50 = {
+declare type Props_54 = {
     /**
      * Filtreler uygulanır. `preventDefault` bileşenin işi; çağıran yalnızca durumunu günceller
      * (sayfayı 1'e almak + aramayı uygulamak gibi).
@@ -1909,11 +2107,26 @@ declare type Props_50 = {
     testId?: string;
 };
 
-declare type Props_51 = LinkProps | ButtonProps;
+declare type Props_55 = LinkProps | ButtonProps;
+
+declare type Props_6 = {
+    /** Tetikleyici. */
+    trigger: ReactElement;
+    children: ReactNode;
+    /** Yüzeyin erişilebilir adı. */
+    label: string;
+    side?: PositionSide;
+    align?: PositionAlign;
+    /** Kontrollü kullanım. */
+    isOpen?: boolean;
+    onOpenChange?: (isOpen: boolean) => void;
+    className?: string;
+    testId?: string;
+};
 
-declare type Props_6<T extends string> = SingleProps<T> | MultipleProps<T>;
+declare type Props_7<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;
@@ -1926,7 +2139,7 @@ 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;
@@ -1956,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;
 
@@ -1987,7 +2189,7 @@ 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;
@@ -2011,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>;
@@ -2040,7 +2242,7 @@ declare type RowProps = HTMLAttributes<HTMLTableRowElement> & {
 export declare const ScrollArea: typeof ScrollArea_2;
 
 /** Kaydırma kutusu — klavyeyle erişilebilir kaydırma bölgesi. */
-declare const ScrollArea_2: FC<Props_31>;
+declare const ScrollArea_2: FC<Props_34>;
 
 declare type ScrollerProps = HTMLAttributes<HTMLDivElement> & {
     /** Çerçeve (hairline + yarıçap + yüzey). */
@@ -2056,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 — görünüm değiştirme. */
-declare const SegmentedControl_2: <T extends string>({ options, value, onChange, label, isIconOnly, size, className, testId, }: Props_7<T>) => JSX.Element;
+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;
@@ -2074,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;
@@ -2098,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>;
 
@@ -2111,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;
@@ -2131,12 +2345,19 @@ 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. */
-declare const SummaryCard_2: FC<Props_34>;
+declare const SummaryCard_2: FC<Props_37>;
 
 export declare type SummaryCardHeadingLevel = 2 | 3 | 4;
 
@@ -2168,7 +2389,7 @@ 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;
 
@@ -2198,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). */
@@ -2218,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";
@@ -2229,12 +2458,12 @@ 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;
@@ -2296,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"
@@ -2307,13 +2538,13 @@ export declare enum UISize {
 
 /** Düğme ve eylem varyantları. */
 export declare enum UIVariant {
-    /** Ekranın tek beklenen eylemi: nötr grafit dolgu. */
+    /** Ekranın tek beklenen eylemi: çam dolgu (koyu temada mint sınırla). Bir ekranda TEK. */
     PRIMARY = "PRIMARY",
     /** 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",
@@ -2348,6 +2579,15 @@ export declare const useHanui: () => HanuiContextValue;
  */
 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;
@@ -2363,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;