@ahmetilhn/hanui 3.3.1 → 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;
 };
@@ -457,33 +406,15 @@ export declare type CommonElementProps = Partial<{
 
 /** YOĞUN (compact) KİP — `<html data-hanui-density="compact">`. */
 export declare const COMPACT_DENSITY: {
-    readonly 'space-2': "6px";
-    readonly 'space-3': "8px";
-    readonly 'space-4': "12px";
-    readonly 'space-5': "16px";
-    readonly 'space-6': "24px";
-    readonly 'space-7': "32px";
-    readonly 'font-size-2xs': "11px";
-    readonly 'font-size-xs': "12px";
-    readonly 'font-size-sm': "13px";
-    readonly 'font-size-base': "15px";
-    readonly 'font-size-body': "16px";
-    readonly 'font-size-lg': "18px";
-    readonly 'font-size-xl': "21px";
-    readonly 'font-size-2xl': "25px";
-    readonly 'font-size-3xl': "31px";
-    readonly 'font-size-4xl': "39px";
-    readonly 'leading-normal': "1.5";
-    readonly 'leading-relaxed': "1.6";
+    readonly 'type-scale': "0.93";
+    readonly 'space-scale': "0.88";
 };
 
 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>;
 
@@ -491,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 = {
@@ -514,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. */
@@ -538,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";
@@ -556,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>;
 
@@ -582,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;
@@ -604,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;
 };
 
@@ -619,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;
@@ -647,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>;
 
@@ -669,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;
@@ -687,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';
 
@@ -714,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;
 };
@@ -742,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`. */
@@ -799,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]>;
@@ -821,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;
@@ -853,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>;
     }>;
 }>;
@@ -864,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>;
 
@@ -878,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. */
@@ -886,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>;
 
@@ -899,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;
@@ -915,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;
@@ -942,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;
@@ -968,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. */
@@ -984,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;
 }>;
 
@@ -1018,89 +865,96 @@ 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>>;
 
 /** AÇIK TEMA — varsayılan. */
 export declare const LIGHT_THEME: {
-    readonly page: "#ffffff";
-    readonly surface: "#ffffff";
-    readonly 'surface-2': "#eff4f1";
-    readonly 'surface-3': "#e8efec";
-    readonly 'surface-inset': "#f9fbfa";
-    readonly border: "#d6e1dc";
-    readonly 'border-strong': "#c5d3cc";
-    readonly text: "#00120f";
-    readonly 'text-2': "#38594f";
-    readonly 'text-3': "#506d63";
-    readonly graphite: "#00322a";
-    readonly 'graphite-2': "#004d40";
-    readonly 'graphite-3': "#0f574a";
+    readonly page: "#f7fcf8";
+    readonly surface: "#fdfefd";
+    readonly 'surface-2': "#e9f7ed";
+    readonly 'surface-3': "#dff3e5";
+    /** Girinti sayfanın ALTINA iner (arama kutusu, kod bloğu, pasif girdi). */
+    readonly 'surface-inset': "#f1faf4";
+    readonly border: "#c0eacf";
+    readonly 'border-strong': "#aaddbf";
+    readonly text: "#010f0b";
+    readonly 'text-2': "#325a4d";
+    readonly 'text-3': "#467060";
+    readonly shell: "#00322a";
+    readonly 'shell-2': "#154c3d";
+    readonly 'shell-3': "#225f4d";
     readonly action: "#00322a";
-    readonly 'action-hover': "#004d40";
-    readonly 'action-active': "#0f574a";
-    readonly 'on-action': "#ffffff";
+    readonly 'action-hover': "#154c3d";
+    readonly 'action-active': "#225f4d";
+    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`). */
-    readonly 'action-soft': "#c5d3cc";
+    /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. */
+    readonly 'action-soft': "#aaddbf";
     /** PASİF DOLGU ÜZERİNDEKİ METİN. */
-    readonly 'on-action-soft': "#26403a";
-    readonly amber: "#22a76d";
-    readonly 'amber-hover': "#2ab97a";
-    readonly 'amber-active': "#1d9a64";
-    readonly 'amber-soft': "#8fd3b6";
-    readonly 'on-amber': "#02180f";
-    readonly blue: "#1a7f61";
-    readonly 'blue-hover': "#10654b";
-    readonly 'blue-active': "#0a4d39";
-    readonly 'blue-text': "#147155";
-    readonly 'blue-tint': "#e9f6f2";
-    readonly 'blue-line': "#acd8cb";
-    readonly 'on-blue': "#ffffff";
-    readonly 'ok-bg': "#e6f4ed";
-    readonly 'ok-fg': "#156f4e";
-    readonly 'ok-line': "#a8dcc4";
-    readonly 'warn-bg': "#fdf0dd";
-    readonly 'warn-fg': "#7a3e02";
-    readonly 'warn-line': "#ebc687";
-    readonly 'off-bg': "#f0f4f3";
-    readonly 'off-fg': "#26403a";
-    readonly 'off-line': "#cddad4";
-    readonly 'bad-bg': "#f8ebeb";
-    readonly 'bad-fg': "#bb1e1e";
-    readonly 'bad-line': "#e6a6a6";
-    readonly 'oem-bg': "#edf8f5";
-    readonly 'oem-fg': "#0d5942";
-    readonly 'oem-line': "#b5ded2";
-    readonly 'alt-bg': "#eeebfa";
-    readonly 'alt-fg': "#2e2661";
-    readonly 'alt-line': "#c0b6ea";
-    readonly 'sale-bg': "#e6f4ed";
-    readonly 'sale-fg': "#156f4e";
-    readonly 'red-accent': "#dc2626";
-    readonly 'green-accent': "#1d9a64";
-    readonly 'green-accent-hover': "#17814f";
-    readonly 'on-green': "#02180f";
-    readonly star: "#9a5f04";
-    readonly 'danger-solid': "#dc2626";
-    readonly 'danger-solid-hover': "#bb1e1e";
-    readonly 'on-danger': "#ffffff";
-    readonly 'nav-bg': "#ffffff";
-    readonly 'nav-bg-2': "#eff4f1";
-    readonly 'nav-fg': "#00120f";
-    readonly 'nav-fg-2': "#38594f";
-    readonly 'nav-fg-3': "#506d63";
-    readonly 'nav-line': "#e3eae7";
-    readonly 'nav-line-strong': "#c5d3cc";
-    readonly 'nav-hover': "#eff4f1";
-    readonly 'footer-bg': "#eff4f1";
+    readonly 'on-action-soft': "#1d4238";
+    readonly cart: "#1ba055";
+    readonly 'cart-hover': "#20b360";
+    readonly 'cart-active': "#19934e";
+    readonly 'cart-soft': "#84cb97";
+    readonly 'on-cart': "#021407";
+    readonly role: "#1f7b56";
+    readonly 'role-hover': "#176446";
+    readonly 'role-active': "#115037";
+    readonly 'role-text': "#17704e";
+    readonly 'role-tint': "#d5f6e4";
+    readonly 'role-line': "#93dfba";
+    readonly 'on-role': "#fdfefd";
+    readonly 'ok-bg': "#c2f6cf";
+    readonly 'ok-fg': "#166e3a";
+    readonly 'ok-line': "#7eda99";
+    readonly 'warn-bg': "#f6e4cf";
+    readonly 'warn-fg': "#7c5212";
+    readonly 'warn-line': "#e8b97f";
+    readonly 'off-bg': "#daece5";
+    readonly 'off-fg': "#4d625a";
+    readonly 'off-line': "#afcabf";
+    readonly 'bad-bg': "#f6e2e0";
+    readonly 'bad-fg': "#a91922";
+    readonly 'bad-line': "#e9b3ae";
+    readonly 'oem-bg': "#a7f7c8";
+    readonly 'oem-fg': "#0c5d3a";
+    readonly 'oem-line': "#6ace97";
+    readonly 'alt-bg': "#e9e4f6";
+    readonly 'alt-fg': "#751dc8";
+    readonly 'alt-line': "#c9bae7";
+    readonly 'sale-bg': "#c2f6cf";
+    readonly 'sale-fg': "#166e3a";
+    readonly 'red-accent': "#de1b2c";
+    readonly 'green-accent': "#18904c";
+    readonly 'green-accent-hover': "#12783e";
+    readonly 'on-green': "#021407";
+    readonly star: "#8c6a11";
+    readonly 'danger-solid': "#c21625";
+    readonly 'danger-solid-hover': "#a2111d";
+    readonly 'on-danger': "#fdfefd";
+    readonly 'nav-bg': "#fdfefd";
+    readonly 'nav-bg-2': "#e9f7ed";
+    readonly 'nav-fg': "#010f0b";
+    readonly 'nav-fg-2': "#325a4d";
+    readonly 'nav-fg-3': "#467060";
+    readonly 'nav-line': "#d5f0de";
+    readonly 'nav-line-strong': "#aaddbf";
+    readonly 'nav-hover': "#e9f7ed";
+    readonly 'footer-bg': "#e9f7ed";
     readonly 'band-bg': "#00322a";
-    readonly 'band-fg': "#eff4f1";
-    readonly 'band-fg-2': "#8fb3a7";
-    readonly 'band-line': "#0a4a3e";
+    readonly 'band-fg': "#e9f7ed";
+    readonly 'band-fg-2': "#8abaa1";
+    /**
+     * 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";
+    readonly 'band-line': "#143f34";
     readonly 'band-hover': string;
     readonly 'shadow-xs': `0 1px 2px ${string}`;
     readonly 'shadow-sm': `0 1px 2px ${string}, 0 1px 3px ${string}`;
@@ -1111,22 +965,22 @@ export declare const LIGHT_THEME: {
     readonly 'shadow-up': `0 -2px 4px ${string}, 0 -8px 24px ${string}`;
     /** Odak halkası MAVİ: odak bir gezinme olayıdır, bir dönüşüm değil. */
     readonly ring: `0 0 0 3px ${string}`;
-    readonly 'ring-color': "#1a7f61";
+    readonly 'ring-color': "#1f7b56";
     readonly 'ring-danger': `0 0 0 3px ${string}`;
     readonly 'ring-ok': `0 0 0 4px ${string}`;
     readonly scrim: string;
     readonly 'scrim-soft': string;
     readonly glass: string;
-    readonly 'glass-solid': "#ffffff";
-    readonly 'on-scrim': "#ffffff";
-    readonly 'skeleton-a': "#eff4f1";
-    readonly 'skeleton-b': "#f9fbfa";
+    readonly 'glass-solid': "#fdfefd";
+    readonly 'on-scrim': "#fdfefd";
+    readonly 'skeleton-a': "#e9f7ed";
+    readonly 'skeleton-b': "#f7fcf8";
     readonly track: string;
     /** Görsel yer tutucu (medya yoksa). */
-    readonly 'media-bg': "#eff4f1";
+    readonly 'media-bg': "#e9f7ed";
     readonly 'glow-1': string;
     readonly 'glow-2': string;
-    readonly 'glow-amber': string;
+    readonly 'glow-cart': string;
 };
 
 declare type LinkProps = BaseProps_4 & {
@@ -1146,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. */
@@ -1182,26 +1036,31 @@ 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. */
+    readonly 'type-scale': "1";
+    readonly 'space-scale': "1";
     readonly 'space-0': "0";
     readonly 'space-1': "4px";
     readonly 'space-2': "8px";
-    readonly 'space-3': "12px";
-    readonly 'space-4': "16px";
-    readonly 'space-5': "24px";
-    readonly 'space-6': "32px";
-    readonly 'space-7': "48px";
-    readonly 'space-8': "64px";
-    readonly 'space-9': "96px";
-    readonly 'font-size-2xs': "12px";
-    readonly 'font-size-xs': "13px";
-    readonly 'font-size-sm': "15px";
-    readonly 'font-size-base': "16px";
-    readonly 'font-size-body': "17px";
-    readonly 'font-size-lg': "19px";
-    readonly 'font-size-xl': "23px";
-    readonly 'font-size-2xl': "29px";
-    readonly 'font-size-3xl': "37px";
-    readonly 'font-size-4xl': "47px";
+    readonly 'space-3': string;
+    readonly 'space-4': string;
+    readonly 'space-5': string;
+    readonly 'space-6': string;
+    readonly 'space-7': string;
+    readonly 'space-8': string;
+    readonly 'space-9': string;
+    readonly 'font-size-2xs': string;
+    readonly 'font-size-xs': string;
+    readonly 'font-size-sm': string;
+    readonly 'font-size-base': string;
+    readonly 'font-size-body': string;
+    readonly 'font-size-lg': string;
+    readonly 'font-size-xl': string;
+    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. */
+    readonly 'font-size-control': `max(16px, ${string})`;
     readonly 'leading-none': "1";
     readonly 'leading-tight': "1.16";
     readonly 'leading-snug': "1.35";
@@ -1223,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;
@@ -1242,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;
@@ -1259,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>;
 
@@ -1277,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 = {
@@ -1288,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. */
@@ -1325,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;
@@ -1351,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>;
@@ -1363,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. */
@@ -1387,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;
@@ -1411,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;
@@ -1428,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;
@@ -1452,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;
@@ -1482,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;
@@ -1518,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;
@@ -1553,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;
@@ -1563,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;
@@ -1591,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;
@@ -1607,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. */
@@ -1645,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;
@@ -1664,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;
@@ -1685,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;
@@ -1703,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;
@@ -1719,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;
@@ -1756,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';
@@ -1782,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;
@@ -1790,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;
@@ -1826,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;
@@ -1866,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;
@@ -1902,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;
@@ -1929,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;
@@ -1937,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;
@@ -1963,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;
@@ -1980,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;
@@ -1994,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;
@@ -2010,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;
@@ -2020,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. */
@@ -2042,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;
@@ -2063,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;
@@ -2105,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;
@@ -2124,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;
@@ -2146,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;
@@ -2159,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;
@@ -2178,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;
@@ -2230,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;
@@ -2277,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;
 };
@@ -2304,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> = {
@@ -2379,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;
@@ -2393,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. */
@@ -2431,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>;
 
@@ -2504,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;
@@ -2517,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;
@@ -2535,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 = {
@@ -2555,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;
 
@@ -2580,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",
@@ -2597,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. */
@@ -2623,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;
 
@@ -2635,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;