@ahmetilhn/hanui 1.0.2 → 1.1.0

package/build/index.d.ts

@@ -120,10 +120,12 @@ declare type BaseProps_3 = {
     title: string;
     /** Girdi alanının etiketi. */
     label: string;
-    submitLabel: string;
-    cancelLabel: string;
-    /** Kapatma düğmesinin erişilebilir adı. */
-    closeLabel: string;
+    /** Verilmezse `labels.submit`. */
+    submitLabel?: string;
+    /** Verilmezse `labels.cancel`. */
+    cancelLabel?: string;
+    /** Kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    closeLabel?: string;
     /** Başlığın altındaki bir cümlelik bağlam. */
     description?: ReactNode;
     hint?: string;
@@ -142,10 +144,12 @@ declare type BaseProps_3 = {
 declare type BaseProps_4 = {
     page: number;
     totalPages: number;
-    /** Gezinme bölgesinin erişilebilir adı ("Sayfalar"). */
-    label: string;
-    previousLabel: string;
-    nextLabel: string;
+    /** Gezinme bölgesinin erişilebilir adı. Verilmezse `labels.pagination.label`. */
+    label?: string;
+    /** Verilmezse `labels.pagination.previous`. */
+    previousLabel?: string;
+    /** Verilmezse `labels.pagination.next`. */
+    nextLabel?: string;
     className?: string;
     testId?: string;
 };
@@ -479,20 +483,27 @@ export declare const Combobox: typeof Combobox_2;
  */
 declare const Combobox_2: <T extends string>({ options, value, onChange, labels, isSearchHidden, onSearch, isLoading, isDisabled, isClearable, icon, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_5<T>) => JSX.Element;
 
-/** Bileşenin çizdiği metinler. Hepsi ZORUNLU: kütüphane dil kararı vermez. */
+/**
+ * Bileşenin çizdiği metinler.
+ *
+ * <p>`placeholder` dışındaki her şey `HanuiProvider labels.combobox`ten de
+ * gelebilir; buradaki değer kazanır. `placeholder` ALANI adlandırır
+ * ("Şehir seçin", "Marka seçin") ve her çağrı yerinde farklıdır — o yüzden
+ * zorunlu kaldı.
+ */
 export declare type ComboboxLabels = {
     /** Seçim yokken tetikleyicide ve alt sayfa başlığında görünen metin. */
     placeholder: string;
     /** Arama kutusunun yer tutucusu ve erişilebilir adı. */
-    searchPlaceholder: string;
+    searchPlaceholder?: string;
     /** Liste boşken gösterilen metin. */
-    emptyMessage: string;
+    emptyMessage?: string;
     /** Arama sürerken liste yerine gösterilen metin. */
-    loadingMessage: string;
+    loadingMessage?: string;
     /** Seçimi kaldıran çarpının erişilebilir adı. */
-    clearLabel: string;
+    clearLabel?: string;
     /** Alt sayfanın kapatma düğmesinin erişilebilir adı. */
-    closeLabel: string;
+    closeLabel?: string;
 };
 
 export declare type ComboboxOption<T extends string = string> = {
@@ -715,8 +726,8 @@ declare type DirectoryJumpProps = {
     labels: string[];
     /** Çıpa kimliğini üretir; `DirectoryGroup id` ile aynı olmalı. */
     toId: (label: string) => string;
-    /** Şeridin erişilebilir adı ("Harfe göre atla"). */
-    label: string;
+    /** Şeridin erişilebilir adı. Verilmezse `labels.directoryJump`. */
+    label?: string;
 };
 
 declare type DirectoryProps = {
@@ -844,6 +855,45 @@ declare const FilterBar_2: FC<Props_34>;
  */
 export declare const FilterBarField: FC<FieldProps>;
 
+/**
+ * ARAYÜZ METİNLERİ.
+ *
+ * <h3>Kütüphane hiçbir dilde metin UYDURMAZ</h3>
+ * Bir bileşen kütüphanesi "Kapat" yazamaz: hangi dilde, hangi üslupta
+ * ("Kapat" mı "Vazgeç" mi), hangi terimle (kayıt / ürün / talep) yazacağını
+ * bilmez. Bu yüzden kullanıcıya görünen her metin dışarıdan gelir.
+ *
+ * <h3>Ama her ÇAĞRI YERİNDE değil, bir KEZ</h3>
+ * Metinleri prop olarak zorunlu tutmak doğruydu ama yeri yanlıştı: aynı
+ * "Kapat" dizesi yüz çağrı yerine dağılıyor ve biri değiştiğinde
+ * doksan dokuzu eski kalıyordu. Uygulamanın dili tek; karar da tek yerde
+ * verilmeli.
+ *
+ * <pre>
+ * &lt;HanuiProvider labels={{ close: 'Kapat', cancel: 'Vazgeç' }}&gt;
+ * </pre>
+ *
+ * <h3>Çözümleme sırası: prop → config → uyarı</h3>
+ * Bir prop verilmişse o kazanır (bir pencerenin kapatma düğmesi bağlama göre
+ * "Kapat" yerine "Daha sonra" olabilir). Verilmemişse config'ten okunur.
+ * İkisi de yoksa öğe erişilebilir adını kaybeder — bu bir hata ve geliştirme
+ * kipinde konsola yazılır (bkz. `helpers/label.helper`).
+ *
+ * <h3>Neden derleme zamanında zorlanamıyor</h3>
+ * TypeScript, çalışma zamanında bir sağlayıcının olup olmadığını göremez.
+ * Prop'ları zorunlu tutmak config'i işe yaramaz kılardı; isteğe bağlı yapmak
+ * derleme güvencesini bırakıp geliştirme uyarısına indiriyor. Bilinçli bir
+ * takas: metnin tek yerde durması, derleyicinin bunu görmesinden daha değerli.
+ *
+ * <h3>Neye metin VERİLMEZ</h3>
+ * Öğeye ÖZGÜ olan hiçbir şey buraya girmez: `Modal.title`,
+ * `ConfirmDialog.confirmLabel` ("Sil" — eylemi tekrarlamak zorunda),
+ * `IconButton.label`, `Select.label`, `TableCheckbox.label`. Bunlar prop
+ * olarak zorunlu kalır çünkü her çağrı yerinde farklıdır.
+ */
+/** Sayı biçimlendiricileri: değere bağlı metinler dizeyle verilemez. */
+declare type Formatter<TArgs extends unknown[]> = (...args: TArgs) => string;
+
 /** Kullanıcının seçtiği tema. `system` işletim sistemi tercihini izler. */
 export declare type HanuiColorScheme = 'light' | 'dark';
 
@@ -859,6 +909,11 @@ export declare type HanuiContextValue = {
     linkComponent?: HanuiLinkComponent;
     /** Uygulanan tema ezmeleri. Salt okunur; değiştirmek için `HanuiProvider`. */
     theme?: HanuiThemeConfig;
+    /**
+     * Arayüz metinleri. Bir bileşen metnini prop olarak almadıysa buradan okur
+     * (bkz. `theme/labels.ts`).
+     */
+    labels?: HanuiLabels;
 };
 
 /**
@@ -879,6 +934,79 @@ export declare type HanuiFonts = Partial<{
     mono: string;
 }>;
 
+export declare type HanuiLabels = Partial<{
+    /** Kip pencere ve alt sayfanın kapatma düğmesi. `Modal`, `BottomSheet`. */
+    close: string;
+    /** Vazgeçme eylemi. `ConfirmDialog`, `PromptDialog`. */
+    cancel: string;
+    /** Kaydetme/gönderme eylemi. `PromptDialog`. */
+    submit: string;
+    /** Bekleme göstergesinin ekran okuyucu metni. `Spinner`. */
+    loading: string;
+    /** Zorunlu alanın yıldızının yanındaki okunabilir karşılık. `Field`. */
+    required: string;
+    /** Filtre şeridinin erişilebilir adı. `FilterBar`. */
+    filters: string;
+    /** Kırıntı yolunun gezinme bölgesi adı. `Breadcrumb`. */
+    breadcrumb: string;
+    /** Alfabe atlama şeridinin gezinme bölgesi adı. `DirectoryJump`. */
+    directoryJump: string;
+    /** Seçim yokken `Select` tetikleyicisinde görünen metin. */
+    selectPlaceholder: string;
+    /**
+     * Baş harf büyütmesinde kullanılacak dil etiketi. `Avatar`.
+     *
+     * <p>Türkçede ZORUNLU: `toUpperCase()` "i" harfini "I" yapıyor ve
+     * "İlhan"ın baş harfi "I" çıkıyor.
+     */
+    locale: string;
+    /** Para birimi simgesi ya da kodu. `Price`. */
+    currency: string;
+    combobox: Partial<{
+        searchPlaceholder: string;
+        emptyMessage: string;
+        loadingMessage: string;
+        clearLabel: string;
+    }>;
+    pagination: Partial<{
+        /** Gezinme bölgesinin adı ("Sayfalar"). */
+        label: string;
+        previous: string;
+        next: string;
+    }>;
+    quantity: Partial<{
+        label: string;
+        decrease: string;
+        increase: string;
+    }>;
+    range: Partial<{
+        /** Alt kulbun ad eki ("En az"). */
+        min: string;
+        /** Üst kulbun ad eki ("En çok"). */
+        max: string;
+    }>;
+    dataTable: Partial<{
+        empty: string;
+        loading: 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. */
+        copy: Formatter<[value: string]>;
+        copied: Formatter<[value: string]>;
+        announcement: 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]>;
+        /** 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. */
+        scale: Record<1 | 2 | 3 | 4 | 5, string>;
+    }>;
+}>;
+
 /** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
 export declare type HanuiLinkComponent = ComponentType<HanuiLinkProps>;
 
@@ -1430,15 +1558,30 @@ declare type Props = {
      * <HanuiProvider linkComponent={NextLink}>…</HanuiProvider>
      */
     linkComponent?: HanuiLinkComponent;
+    /**
+     * Arayüz metinleri — bir kez, burada.
+     *
+     * <p>Kütüphane hiçbir dilde metin uydurmaz ama aynı "Kapat" dizesini yüz
+     * çağrı yerine dağıtmak da doğru değildi: biri değiştiğinde doksan dokuzu
+     * eski kalıyordu. Çözümleme sırası prop → buradaki config; ikisi de yoksa
+     * geliştirme kipinde konsola uyarı düşer.
+     *
+     * <p>Öğeye ÖZGÜ metinler buraya girmez (`Modal.title`,
+     * `ConfirmDialog.confirmLabel`, `IconButton.label`); onlar prop olarak
+     * zorunlu kalır çünkü her çağrı yerinde farklıdır.
+     */
+    labels?: HanuiLabels;
 };
 
 declare type Props_10 = {
     value: number;
     onChange: (value: number) => void;
-    /** Grubun ve girdinin erişilebilir adı ("Adet"). */
-    label: string;
-    decreaseLabel: string;
-    increaseLabel: string;
+    /** Grubun ve girdinin erişilebilir adı. Verilmezse `labels.quantity.label`. */
+    label?: string;
+    /** Verilmezse `labels.quantity.decrease`. */
+    decreaseLabel?: string;
+    /** Verilmezse `labels.quantity.increase`. */
+    increaseLabel?: string;
     min?: number;
     max?: number;
     isDisabled?: boolean;
@@ -1447,7 +1590,17 @@ declare type Props_10 = {
     testId?: string;
 };
 
-declare type Props_11 = BaseProps_2 & RequiredProps;
+declare type Props_11 = BaseProps_2 & {
+    isRequired?: boolean;
+    /**
+     * Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)").
+     *
+     * <p>Yıldız yalnızca GÖRSEL bir kısayol; renk ve şekil tek başına anlam
+     * taşıyamaz (WCAG 1.4.1), o yüzden yanında okunabilir bir metin olmak
+     * zorunda. Verilmezse `labels.required` okunur.
+     */
+    requiredLabel?: string;
+};
 
 declare type Props_12 = {
     children: ReactNode;
@@ -1472,7 +1625,7 @@ declare type Props_13 = {
      *
      * <p>Türkçede ZORUNLU: `toUpperCase()` "i" harfini "I" yapıyor ve "İlhan"ın
      * baş harfi "I" çıkıyor. `toLocaleUpperCase('tr')` doğru "İ" verir.
-     * Verilmezse çalışma ortamının varsayılan dili kullanılır.
+     * Verilmezse `labels.locale`, o da yoksa çalışma ortamının varsayılan dili.
      */
     locale?: string;
     size?: 'sm' | 'md' | 'lg';
@@ -1492,8 +1645,8 @@ declare type Props_14 = {
 
 declare type Props_15 = {
     items: Crumb[];
-    /** Gezinme bölgesinin erişilebilir adı ("Konum", "Breadcrumb"). */
-    label: string;
+    /** Gezinme bölgesinin erişilebilir adı. Verilmezse `labels.breadcrumb`. */
+    label?: string;
     /** Yönlendiriciye geçirilecek ek props. */
     linkProps?: HanuiLinkExtraProps;
     className?: string;
@@ -1503,12 +1656,19 @@ declare type Props_15 = {
 declare type Props_16 = {
     /** Gösterilecek ve panoya kopyalanacak değer. */
     value: string;
-    /** Kopyalama düğmesinin erişilebilir adı ve `title`ı. */
-    copyLabel: string;
-    /** Kopyalandıktan sonraki erişilebilir ad ve `title`. */
-    copiedLabel: string;
-    /** `aria-live` ile duyurulan onay cümlesi ("Panoya kopyalandı"). */
-    copiedAnnouncement: string;
+    /**
+     * Kopyalama düğmesinin erişilebilir adı ve `title`ı.
+     *
+     * <p>Verilmezse `labels.copyField.copy(value)` çağrılır. Config bir DİZE
+     * değil biçimlendirici tutar: ad değeri İÇERMELİ — bir listede on beş
+     * kopyalama düğmesi var ve hepsi "Kopyala" diye okunduğunda ekran okuyucu
+     * kullanıcısı hangisinin hangi kayıt olduğunu bilmiyordu.
+     */
+    copyLabel?: string;
+    /** Kopyalandıktan sonraki ad. Verilmezse `labels.copyField.copied(value)`. */
+    copiedLabel?: string;
+    /** `aria-live` ile duyurulan onay cümlesi. Verilmezse `labels.copyField.announcement`. */
+    copiedAnnouncement?: string;
     size?: 'sm' | 'md';
     /**
      * Kopyalama düğmesini gizler.
@@ -1600,8 +1760,8 @@ declare type Props_20 = {
 declare type Props_21 = {
     /** BİÇİMLENMİŞ tutar: "1.299,90". Bileşen hesap yapmaz. */
     value: string;
-    /** Para birimi simgesi ya da kodu: "₺", "$", "EUR". */
-    currency: string;
+    /** Para birimi simgesi ya da kodu. Verilmezse `labels.currency`. */
+    currency?: string;
     /** Üstü çizili liste fiyatı; indirim varsa verilir (biçimlenmiş). */
     listValue?: string;
     /** İndirim oranı (tam sayı yüzde). */
@@ -1619,13 +1779,16 @@ declare type Props_22 = {
     /** Değerlendirme sayısı; verilirse yıldızların yanında gösterilir. */
     count?: number;
     /**
-     * Ekran okuyucuya okunan metin — ZORUNLU.
+     * Ekran okuyucuya okunan metin.
      *
      * <p>Yıldızlar `aria-hidden`: beş ayrı ikonu tek tek duyurmak anlamsız.
      * Yerine bir cümle okunur ("5 üzerinden 4,5 — 12 değerlendirme") ve o cümle
      * hem dile hem sayı biçimine bağlı; kütüphane onu uyduramaz.
+     *
+     * <p>Verilmezse `labels.rating.srLabel(value, count)` çağrılır — cümle
+     * değere bağlı olduğu için config bir DİZE değil bir biçimlendirici tutar.
      */
-    srLabel: string;
+    srLabel?: string;
     size?: 'sm' | 'md';
     className?: string;
     testId?: string;
@@ -1660,13 +1823,12 @@ declare type Props_25 = {
     /**
      * Ekran okuyucuya okunacak metin; görsel olarak gizli.
      *
-     * <p>ZORUNLU ve boş dizeye izin verilir. Bekleme durumunun duyurulması
-     * gerekiyor ("Yükleniyor"), ama göstergenin <em>zaten adı olan</em> bir
-     * öğenin içinde durduğu yerlerde (yükleniyor durumundaki bir düğme)
-     * duyurmak tekrar üretiyor. O zaman `label=""` geçilir; karar çağıranın
-     * ve bilinçli olmak zorunda.
+     * <p>Verilmezse `labels.loading` okunur. Boş dizeye BİLİNÇLİ olarak izin
+     * verilir: göstergenin <em>zaten adı olan</em> bir öğenin içinde durduğu
+     * yerlerde (yükleniyor durumundaki bir düğme) duyurmak tekrar üretiyor.
+     * `label=""` orada doğru olan ve config'i de bastırır.
      */
-    label: string;
+    label?: string;
     className?: string;
 };
 
@@ -1705,8 +1867,8 @@ declare type Props_27 = {
 
 declare type Props_28 = {
     title: string;
-    /** Kapatma düğmesinin erişilebilir adı. */
-    closeLabel: string;
+    /** Kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    closeLabel?: string;
     onClose: () => void;
     children: ReactNode;
     /**
@@ -1733,8 +1895,13 @@ declare type Props_29 = {
     isOpen: boolean;
     onClose: () => void;
     title: string;
-    /** Kapatma düğmesinin erişilebilir adı ("Kapat", "Close"). */
-    closeLabel: string;
+    /**
+     * Kapatma düğmesinin erişilebilir adı.
+     *
+     * <p>Verilmezse `HanuiProvider labels.close` okunur. Bağlama göre farklı
+     * olması gereken pencerelerde ("Daha sonra") prop kazanır.
+     */
+    closeLabel?: string;
     children?: ReactNode;
     /**
      * Başlığın altındaki bir cümlelik açıklama.
@@ -1788,17 +1955,36 @@ declare type Props_30 = {
     title: string;
     /** Sonucu açıklar: neyin geri alınamaz olduğu burada yazılır. */
     description?: ReactNode;
-    /** Onay düğmesinin etiketi. Eylemi TEKRARLAR: "Sil", "İptal et". */
+    /**
+     * Onay düğmesinin etiketi — ZORUNLU, config'ten okunmaz.
+     *
+     * <p>Eylemi TEKRARLAR: "Sil", "İptal et". Her pencerede farklı olduğu için
+     * uygulama düzeyinde bir varsayılanı olamaz; "Tamam" gibi bir varsayılan
+     * kullanıcıya neyi onayladığını söylemez ve `window.confirm()`ten kaçmamızın
+     * sebeplerinden biri tam olarak buydu.
+     */
     confirmLabel: string;
-    cancelLabel: string;
-    /** Kapatma düğmesinin erişilebilir adı. */
-    closeLabel: string;
+    /** Verilmezse `labels.cancel`. */
+    cancelLabel?: string;
+    /** Verilmezse `labels.close`. */
+    closeLabel?: string;
     kind?: ConfirmKind;
     /** Ek bağlam: silinecek kaydın özeti, uyarı kutusu. */
     children?: ReactNode;
 };
 
-declare type Props_31 = BaseProps_3 & RequiredProps_2;
+declare type Props_31 = BaseProps_3 & {
+    /** Boş (yalnızca boşluk dahil) değer gönderilemez. */
+    isRequired?: boolean;
+    /**
+     * Zorunluluk yıldızının ekran okuyucu karşılığı ("(zorunlu)").
+     *
+     * <p>Yıldız yalnızca GÖRSEL bir kısayol; renk ve şekil tek başına anlam
+     * taşıyamaz (WCAG 1.4.1), o yüzden yanında okunabilir bir metin olmak
+     * zorunda. Verilmezse `labels.required` okunur.
+     */
+    requiredLabel?: string;
+};
 
 declare type Props_32 = TableHTMLAttributes<HTMLTableElement> & Partial<{
     /**
@@ -1826,10 +2012,10 @@ declare type Props_33 = {
      * üstlenir. Uyarı tinti için {@link DataTableRow}.
      */
     children?: ReactNode;
-    /** Satır yokken gösterilen metin. */
-    emptyMessage: string;
-    /** Yükleme sürerken satırların yerine gösterilen metin. */
-    loadingMessage: string;
+    /** Satır yokken gösterilen metin. Verilmezse `labels.dataTable.empty`. */
+    emptyMessage?: string;
+    /** Yükleme sürerken gösterilen metin. Verilmezse `labels.dataTable.loading`. */
+    loadingMessage?: string;
     isLoading?: boolean;
     /**
      * Liste ÇEKİLEMEDİ. <strong>"Yüklenemedi" ile "boş" ayrı durumlardır</strong>:
@@ -1859,8 +2045,8 @@ declare type Props_34 = {
     children: ReactNode;
     /** Şeridin sağ ucundaki eylemler ("Uygula" düğmesi gibi). */
     actions?: ReactNode;
-    /** Şeridin erişilebilir adı ("Filtreler"). */
-    label: string;
+    /** Şeridin erişilebilir adı. Verilmezse `labels.filters`. */
+    label?: string;
     className?: string;
     testId?: string;
 };
@@ -1914,10 +2100,10 @@ declare type Props_6<T extends string> = {
      * seçili değeri okur ("En yeni, düğme") ve neyi seçtiğini söylemez.
      */
     label: string;
-    /** Seçim yokken tetikleyicide görünen metin. */
-    placeholder: string;
-    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. */
-    closeLabel: string;
+    /** Seçim yokken tetikleyicide görünen metin. Verilmezse `labels.selectPlaceholder`. */
+    placeholder?: string;
+    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. Verilmezse `labels.close`. */
+    closeLabel?: string;
     /** Tetikleyicinin solundaki ikon. */
     icon?: ReactNode;
     /** `sm` yoğun şeritler içindir (araç çubuğu); varsayılan form ölçüsü `md`. */
@@ -1964,10 +2150,10 @@ declare type Props_8 = {
     formatValue?: (value: number) => string;
     /** Grubun erişilebilir adı ("Fiyat aralığı"). */
     label: string;
-    /** Alt kulbun erişilebilir ad eki ("En az"). */
-    minLabel: string;
-    /** Üst kulbun erişilebilir ad eki ("En çok"). */
-    maxLabel: string;
+    /** Alt kulbun erişilebilir ad eki. Verilmezse `labels.range.min`. */
+    minLabel?: string;
+    /** Üst kulbun erişilebilir ad eki. Verilmezse `labels.range.max`. */
+    maxLabel?: string;
     isDisabled?: boolean;
     className?: string;
     testId?: string;
@@ -1979,16 +2165,19 @@ declare type Props_9 = {
     /** Grubun erişilebilir adı ("Ürün puanı"). */
     label: string;
     /**
-     * Puan açıklamaları — ZORUNLU. Hem ekran okuyucuya okunur hem de seçildiğinde
-     * yıldızların altında yazar.
+     * Puan açıklamaları. Hem ekran okuyucuya okunur hem de seçildiğinde
+     * yıldızların altında yazar. Verilmezse `labels.rating.scale`.
      *
      * <p>Dolu yıldız sayısı tek başına bir renk/şekil sinyali. Yanına açıklama
      * yazmak hem anlamı netleştirir hem de renk körü kullanıcıya ikinci bir ipucu
      * verir (WCAG 1.4.1).
      */
-    ratingLabels: RatingLabels;
-    /** Ekran okuyucuda yıldız sayısını okuyan biçimlendirici ("4 yıldız"). */
-    formatStarCount: (star: number) => string;
+    ratingLabels?: RatingLabels;
+    /**
+     * Ekran okuyucuda yıldız sayısını okuyan biçimlendirici ("4 yıldız").
+     * Verilmezse `labels.rating.starCount`.
+     */
+    formatStarCount?: (star: number) => string;
     isDisabled?: boolean;
     className?: string;
     testId?: string;
@@ -2120,30 +2309,6 @@ declare const RatingInput_2: ({ value, onChange, label, ratingLabels, formatStar
 /** Beş puanın her birinin ne anlama geldiği. */
 export declare type RatingLabels = Record<1 | 2 | 3 | 4 | 5, string>;
 
-/**
- * Zorunluluk işareti ve onun ekran okuyucu karşılığı BİRLİKTE verilir.
- *
- * <p>Yıldız yalnızca görsel bir kısayol; renk ve şekil tek başına anlam
- * taşıyamaz (WCAG 1.4.1). `requiredLabel` bir dil kararı ve kütüphane onu
- * uyduramaz — bu yüzden `isRequired` verildiğinde tip zorunlu kılıyor.
- */
-declare type RequiredProps = {
-    isRequired: true;
-    requiredLabel: string;
-} | {
-    isRequired?: false;
-    requiredLabel?: never;
-};
-
-/** Zorunluluk işareti ve ekran okuyucu karşılığı birlikte (bkz. {@link Field}). */
-declare type RequiredProps_2 = {
-    isRequired: true;
-    requiredLabel: string;
-} | {
-    isRequired?: false;
-    requiredLabel?: never;
-};
-
 /** Verilen şemanın tam token eşlemesi — ezmeler uygulanmış hâliyle. */
 export declare const resolveTokens: (scheme: HanuiColorScheme, config?: HanuiThemeConfig) => HanuiResolvedTokens;