@ahmetilhn/hanui 2.7.1 → 3.0.0

package/build/index.d.ts

@@ -49,6 +49,12 @@ 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.
+ */
+export declare const applyThemeConfig: (config: HanuiThemeConfig | undefined) => void;
+
 export declare const Avatar: typeof Avatar_2;
 
 /** Avatar — kullanıcı madalyonu. */
@@ -529,6 +535,12 @@ 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">`.
+ */
+export declare const DENSITY_ATTRIBUTE = "data-hanui-density";
+
 export declare const Directory: typeof Directory_2;
 
 /**
@@ -707,6 +719,13 @@ export declare type HanuiFonts = Partial<{
 export declare type HanuiLabels = Partial<{
     /** Kip pencere ve alt sayfanın kapatma düğmesi. `Modal`, `BottomSheet`. */
     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.
+     */
+    notifications: string;
     /** Vazgeçme eylemi. `ConfirmDialog`, `PromptDialog`. */
     cancel: string;
     /** Kaydetme/gönderme eylemi. `PromptDialog`. */
@@ -765,6 +784,49 @@ export declare type HanuiLabels = Partial<{
         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]>;
+        /** Yukleme sirasindaki ekran okuyucu duyurusu. */
+        uploading: Formatter<[name: string]>;
+        /** Dosya secildiginde yapilan duyuru. */
+        added: Formatter<[count: number]>;
+    }>;
+    /**
+     * 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.
+     */
+    stat: Partial<{
+        increase: string;
+        decrease: string;
+        unchanged: string;
+    }>;
+    /** Adim gostergesinin DURUM metinleri — hepsi sr-only. */
+    steps: Partial<{
+        completed: string;
+        current: string;
+        upcoming: string;
+    }>;
+    /** Zaman cizelgesinin DURUM metinleri — hepsi sr-only. */
+    timeline: Partial<{
+        completed: string;
+        current: string;
+        failed: string;
+    }>;
+    /** Etiket girisi. `removed` bir bicimlendirici: hangi etiketin kalktigi. */
+    tagInput: Partial<{
+        added: Formatter<[value: string]>;
+        removed: Formatter<[value: string]>;
+    }>;
     rating: Partial<{
         /** Yıldızların ekran okuyucu karşılığı ("5 üzerinden 4,5 — 12 değerlendirme"). */
         srLabel: Formatter<[value: number, count: number | undefined]>;
@@ -868,6 +930,13 @@ export declare type HanuiToken = keyof typeof LIGHT_THEME;
 declare type HubProps = {
     /** Kapatma düğmelerinin erişilebilir adı. Verilmezse `labels.close`. */
     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.
+     */
+    regionLabel?: string;
     className?: string;
 };
 
@@ -933,9 +1002,6 @@ isTechnical?: boolean;
 testId?: string;
 } & RefAttributes<HTMLInputElement>>;
 
-/** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */
-export declare const isKeyboardOpeningElement: (element: Element | null) => boolean;
-
 /** AÇIK TEMA — varsayılan. */
 export declare const LIGHT_THEME: {
     readonly page: "#ffffff";
@@ -1244,12 +1310,6 @@ export declare type PositioningState = {
 /** Yüzeyin tercih ettiği kenar. Yer yoksa karşıtına düşer. */
 export declare type PositionSide = 'top' | 'bottom' | 'left' | 'right';
 
-/**
- * `showModal()` ÇAĞRILDIKTAN SONRA çağrılır. Odak bir metin alanına düştüyse
- * panelin kendisine geri alınır; düşmediyse hiçbir şey yapılmaz.
- */
-export declare const preventAutoKeyboard: (dialog: HTMLDialogElement) => void;
-
 export declare const Price: typeof Price_2;
 
 /** Tutar gösterimi. */
@@ -1926,6 +1986,16 @@ declare type Props_46 = TableHTMLAttributes<HTMLTableElement> & Partial<{
 
 declare type Props_47 = {
     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.
+     */
+    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ı
@@ -2129,6 +2199,14 @@ declare type ScrollerProps = HTMLAttributes<HTMLDivElement> & {
      * görünüyordu.
      */
     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.
+     */
+    label?: string;
 };
 
 export declare const SectionHeader: typeof SectionHeader_2;
@@ -2258,6 +2336,16 @@ declare const TableCheckbox_2: ForwardRefExoticComponent<Omit<InputHTMLAttribute
 * okunur. Satır kutusunda kaydın kimliğini söyleyin ("SP-2026-000123 seç").
 */
 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.
+*/
+isIndeterminate?: boolean;
 testId?: string;
 } & RefAttributes<HTMLInputElement>>;
 
@@ -2299,6 +2387,9 @@ 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;
 
+/** Temanın taşındığı öznitelik. `<html data-hanui-theme="dark">`. */
+export declare const THEME_ATTRIBUTE = "data-hanui-theme";
+
 export declare const Tile: typeof Tile_2;
 
 /** Karo — ikon madalyonu + etiket. */
@@ -2344,7 +2435,7 @@ export declare const toast: {
 export declare const ToastHub: typeof ToastHub_2;
 
 /** Bildirim yığını — uygulamada <strong>BİR KEZ</strong> çizilir. */
-declare const ToastHub_2: ({ closeLabel, className }: HubProps) => ReactPortal | null;
+declare const ToastHub_2: ({ closeLabel, regionLabel, className }: HubProps) => ReactPortal | null;
 
 export declare type ToastOptions = {
     tone?: ToastTone;
@@ -2452,18 +2543,6 @@ export declare const usePositioning: (anchorRef: {
     current: HTMLElement | null;
 }, { side, align, offset, padding, isOpen }: PositioningOptions) => PositioningState;
 
-export declare const useScrollLock: (isLocked?: boolean) => void;
-
-/**
- * Alt sayfayi <strong>gorunen</strong> alana yaslar.
- *
- * @param isActive Panel acik mi. Yalnizca acikken olculur: kendisi yalnizca
- * acikken cizilen bir panel varsayilani kullanir, ama sayfa boyunca DOM'da
- * duran bir panel bayraksiz cagirdiginda her kullanicida iki gorunum alani
- * dinleyicisi bos yere acik kaliyordu.
- */
-export declare const useSheetViewport: (isActive?: boolean) => void;
-
 /** SANALLAŞTIRMA — yalnızca görünen satırları çiz. */
 export declare const useVirtualList: (count: number, { rowHeight, overscan, isEnabled }?: {
     rowHeight?: number | undefined;