@ahmetilhn/hanui 4.0.0 → 4.1.0

package/build/index.d.ts

@@ -49,10 +49,7 @@ 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;
@@ -102,13 +99,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 +110,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,20 +126,17 @@ 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;
@@ -171,11 +157,7 @@ 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;
@@ -191,10 +173,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;
@@ -211,23 +190,14 @@ 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 +208,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;
 };
@@ -299,7 +264,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 +274,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>>;
@@ -346,7 +304,7 @@ 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. */
@@ -360,15 +318,7 @@ 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, marka zeminli çerçeve. */
 declare const CodeBadge_2: FC<Props_22>;
 
 export declare type CodeBadgeSize = 'sm' | 'md' | 'lg';
@@ -408,9 +358,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 +371,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 +384,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;
 };
@@ -455,18 +404,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,9 +414,7 @@ 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>;
 
@@ -486,10 +422,7 @@ export declare type ConfirmKind = 'destructive' | 'warning' | 'neutral';
 
 export declare const CopyField: typeof CopyField_2;
 
-/**
- * Kopyalanabilir teknik değer — <strong>tek dokunuşla panoya</strong>.
- * Pano mantığı `useCopyFeedback`te, `CodeBadge` ile ortak.
- */
+/** Kopyalanabilir teknik değer — tek dokunuşla panoya. */
 declare const CopyField_2: FC<Props_23>;
 
 export declare type Crumb = {
@@ -509,19 +442,15 @@ declare const DataTable_2: FC<Props_49>;
 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 +462,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 +480,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 +497,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 +516,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 +531,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;
@@ -642,15 +559,8 @@ 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>;
 
@@ -664,17 +574,14 @@ 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. */
+/** 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;
 
 export declare const FilterBar: typeof FilterBar_2;
@@ -682,24 +589,18 @@ export declare const FilterBar: typeof FilterBar_2;
 /** Filtre şeridi. */
 declare const FilterBar_2: FC<Props_50>;
 
-/**
- * Ş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 +610,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 +635,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`. */
@@ -794,18 +691,14 @@ export declare type HanuiLabels = Partial<{
         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. */
+        /** 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 +709,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 +738,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 +748,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 +759,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 +767,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: { blue: '#0d6efd' } }}> <App…
  */
 export declare const HanuiProvider: FC<Props>;
 
@@ -894,15 +776,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: { blue: '#0d6efd', 'blue-text': '#0a58ca' }, dark: {…
  */
 export declare type HanuiThemeConfig = Partial<{
     light: HanuiThemeTokens;
@@ -910,24 +784,18 @@ 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;
 }>;
 
 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 +805,19 @@ 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;
 
 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,10 +830,7 @@ 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 — ekranda görünen tek doygun turuncu odur. */
 variant?: IconButtonVariant;
 size?: "sm" | "md";
 /** Verilirse öğe bir bağlantı olarak çizilir. */
@@ -979,29 +843,17 @@ testId?: string;
 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,7 +865,7 @@ 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>>;
@@ -1040,7 +892,7 @@ export declare const LIGHT_THEME: {
     readonly 'on-action': "#fdfefd";
     /** 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`). */
+    /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. */
     readonly 'action-soft': "#aaddbf";
     /** PASİF DOLGU ÜZERİNDEKİ METİN. */
     readonly 'on-action-soft': "#1d4238";
@@ -1097,11 +949,8 @@ export declare const LIGHT_THEME: {
     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";
@@ -1151,7 +1000,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. */
@@ -1187,12 +1036,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 +1059,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";
@@ -1248,10 +1082,7 @@ export declare const METRIC_TOKENS: {
     readonly 'duration-shimmer': "1400ms";
 };
 
-/**
- * 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;
@@ -1267,7 +1098,7 @@ 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;
@@ -1284,11 +1115,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">
- * <PanelForm>…alanlar…</PanelForm>
- * </Panel>
+ * @example <Panel title="Profil bilgileri" description="Fatura bu bilgilerle kesilir">…
  */
 declare const Panel_2: FC<Props_27>;
 
@@ -1302,7 +1129,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,17 +1140,14 @@ 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>;
 
 export declare const Popover: typeof Popover_2;
 
-/** Popover — <strong>eylem taşıyabilen</strong>, odaklanabilir yüzey. */
+/** 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;
 
 /** Tercih edilen kenar boyunca hizalama. */
@@ -1350,23 +1174,16 @@ 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;
@@ -1376,7 +1193,7 @@ declare const Price_2: FC<Props_28>;
 
 export declare const Progress: typeof Progress_2;
 
-/** İlerleme çubuğu — <strong>ölçülebilir</strong> bekleme. */
+/** İlerleme çubuğu — ölçülebilir bekleme. */
 declare const Progress_2: ({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: Props_35) => JSX.Element;
 
 export declare const ProgressCircle: MemoExoticComponent<({ value, max, label, valueText, isValueVisible, tone, size, className, testId, }: CircleProps) => JSX.Element>;
@@ -1388,17 +1205,11 @@ declare const PromptDialog_2: FC<Props_47>;
 
 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. */
@@ -1412,18 +1223,15 @@ declare type Props_10 = {
     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;
@@ -1436,14 +1244,10 @@ declare type Props_11 = {
     /** 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;
@@ -1453,7 +1257,7 @@ declare type Props_11 = {
 declare type Props_12 = {
     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;
@@ -1477,18 +1281,18 @@ declare type Props_13 = Omit<InputHTMLAttributes<HTMLInputElement>, 'type'> & {
 declare type Props_14 = {
     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;
@@ -1507,14 +1311,14 @@ declare type Props_16 = {
     /** 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;
@@ -1543,10 +1347,7 @@ declare type Props_17 = {
 declare type Props_18 = {
     /** Tam ad; baş harfler buradan üretilir ve görsel yoksa `alt` metnidir. */
     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ş harfleri büyütürken kullanılacak dil etiketi ("tr", "az"). */
     locale?: string;
@@ -1578,7 +1379,7 @@ declare type Props_2 = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {
 
 declare type Props_20 = {
     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;
@@ -1588,23 +1389,18 @@ declare type Props_20 = {
 
 declare type Props_21 = {
     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;
@@ -1616,11 +1412,11 @@ declare type Props_22 = {
     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;
     className?: string;
@@ -1632,9 +1428,9 @@ declare type Props_23 = {
     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. */
@@ -1670,14 +1466,11 @@ declare type Props_26 = {
     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;
@@ -1689,7 +1482,7 @@ declare type Props_26 = {
 
 declare type Props_27 = {
     children: ReactNode;
-    /** Panel başlığı. Verilmezse başlık şeridi hiç çizilmez. */
+    /** Panel başlığı. */
     title?: string;
     /** Başlık altındaki tek satırlık açıklama. */
     description?: ReactNode;
@@ -1710,9 +1503,9 @@ declare type Props_27 = {
 };
 
 declare type Props_28 = {
-    /** BİÇİMLENMİŞ tutar: "1.299,90". Bileşen hesap yapmaz. */
+    /** 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;
@@ -1728,7 +1521,7 @@ declare type Props_28 = {
 };
 
 declare type Props_29 = {
-    /** 0–5 arası puan. Yarım yıldız desteklenir. */
+    /** 0–5 arası puan. */
     value: number;
     /** Değerlendirme sayısı; verilirse yıldızların yanında gösterilir. */
     count?: number;
@@ -1744,23 +1537,14 @@ declare type Props_3 = {
     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`).
-     */
+    /** Tercih edilen kenar. */
     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.
-     */
+    /** Açılma gecikmesi (ms). */
     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.
+     * 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;
@@ -1781,7 +1565,7 @@ declare type Props_30 = {
 
 declare type Props_31 = {
     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';
@@ -1807,7 +1591,7 @@ declare type Props_32 = {
 declare type Props_33 = {
     /** Ö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,16 +1599,13 @@ 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. */
     variant?: 'card' | 'plain';
     size?: 'sm' | 'md';
     className?: string;
@@ -1851,13 +1632,12 @@ declare type Props_34 = {
 
 declare type Props_35 = {
     /**
-     * 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;
@@ -1891,20 +1671,11 @@ declare type Props_37 = {
 
 declare type Props_38 = {
     steps: StepItem[];
-    /**
-     * 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).
-     */
+    /** 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;
@@ -1927,10 +1698,10 @@ declare type Props_39 = {
 };
 
 declare type Props_4 = {
-    /** Tetikleyici. TEK öğe; bileşen ona `ref` ve ARIA ekliyor. */
+    /** Tetikleyici. */
     trigger: ReactElement;
     items: MenuItem[];
-    /** Menünün erişilebilir adı ("Satır eylemleri"). ZORUNLU. */
+    /** Menünün erişilebilir adı ("Satır eylemleri"). */
     label: string;
     side?: PositionSide;
     align?: PositionAlign;
@@ -1954,7 +1725,7 @@ declare type Props_40 = {
 
 declare type Props_41 = {
     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;
@@ -1962,18 +1733,18 @@ declare type Props_41 = {
 
 declare type Props_42 = {
     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;
@@ -1988,7 +1759,7 @@ 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;
@@ -2005,11 +1776,11 @@ declare type Props_44 = {
     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;
     className?: string;
     testId?: string;
@@ -2019,11 +1790,11 @@ declare type Props_45 = {
     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,7 +1806,7 @@ 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;
@@ -2045,10 +1816,10 @@ declare type Props_46 = {
     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. */
@@ -2067,18 +1838,9 @@ declare type Props_47 = BaseProps_3 & {
 };
 
 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.
-     */
+    /** 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;
@@ -2088,38 +1850,25 @@ declare type Props_49 = {
     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;
@@ -2130,17 +1879,14 @@ declare type Props_49 = {
 };
 
 declare type Props_5 = {
-    /**
-     * Tetikleyici. TEK bir öğe olmak zorunda: bileşen ona `ref`, `onClick` ve
-     * `aria-expanded` ekliyor.
-     */
+    /** 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;
@@ -2149,15 +1895,15 @@ declare type Props_5 = {
 
 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).
+     * 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. */
+    /** Alanlar — her biri FilterBarField içinde. */
     children: ReactNode;
     /** Şeridin sağ ucundaki eylemler ("Uygula" düğmesi gibi). */
     actions?: ReactNode;
-    /** Şeridin erişilebilir adı. Verilmezse `labels.filters`. */
+    /** Şeridin erişilebilir adı. */
     label?: string;
     className?: string;
     testId?: string;
@@ -2171,7 +1917,7 @@ declare type Props_7<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;
@@ -2184,14 +1930,11 @@ declare type Props_8<T extends string> = {
     options: SelectOption<T>[];
     value: T;
     onChange: (value: T) => void;
-    /**
-     * Alanın adı. İki işi birden yapar: alt sayfanın başlığı olur ve
-     * tetikleyicinin <strong>erişilebilir adı</strong>dır.
-     */
+    /** 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 +1946,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;
@@ -2255,11 +1992,11 @@ declare const RadioCard_2: FC<Props_9>;
 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;
@@ -2302,22 +2039,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. */
+/** Kaydırma kutusu — klavyeyle erişilebilir kaydırma bölgesi. */
 declare const ScrollArea_2: FC<Props_31>;
 
 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;
 };
@@ -2329,7 +2060,7 @@ declare const SectionHeader_2: FC<Props_30>;
 
 export declare const SegmentedControl: typeof SegmentedControl_2;
 
-/** Bölmeli denetim — <strong>görünüm</strong> değiştirme. */
+/** 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;
 
 export declare type SegmentOption<T extends string = string> = {
@@ -2404,13 +2135,7 @@ declare const Steps_2: FC<Props_38>;
 
 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.
- */
+/** Özet kartı — başlık + kısa açıklama + meta satırı taşıyan BAĞLANTILI kart. */
 declare const SummaryCard_2: FC<Props_34>;
 
 export declare type SummaryCardHeadingLevel = 2 | 3 | 4;
@@ -2418,15 +2143,8 @@ 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. */
@@ -2456,28 +2174,20 @@ 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>;
 
@@ -2529,7 +2239,7 @@ declare const Timeline_2: FC<Props_41>;
 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 +2252,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 +2267,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 +2287,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;
 
@@ -2605,16 +2307,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: nötr grafit dolgu. */
     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").
-     */
+    /** Mavi ç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 +2321,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,9 +2344,7 @@ 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;
 
@@ -2660,8 +2354,8 @@ export declare const useListboxNavigation: <T extends HTMLElement = HTMLElement>
 }) => 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;