@ahmetilhn/hanui 1.0.1

package/build/index.d.ts

@@ -0,0 +1,2576 @@
+import { AnchorHTMLAttributes } from 'react';
+import { ButtonHTMLAttributes } from 'react';
+import { ComponentType } from 'react';
+import { ElementType } from 'react';
+import { FC } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
+import { JSX } from 'react';
+import { MemoExoticComponent } from 'react';
+import { ReactNode } from 'react';
+import { ReactPortal } from 'react';
+import { RefAttributes } from 'react';
+import { TableHTMLAttributes } from 'react';
+import { TextareaHTMLAttributes } from 'react';
+
+/** Seçim kutusunun alt sayfası yalnızca bu ölçünün altında kullanılır. */
+export declare const ABOVE_MOBILE_MEDIA_QUERY = "(min-width: 641px)";
+
+/** Kenar çubuğu ekranda olduğu için filtre paneli bu ölçünün üstünde gizlenir. */
+export declare const ABOVE_TABLET_MEDIA_QUERY = "(min-width: 1025px)";
+
+export declare const Alert: typeof Alert_2;
+
+/**
+ * Bilgi / uyarı kutusu.
+ *
+ * <p>`danger` ve `warning` tonları `role="alert"` taşır: ekran okuyucu bunları
+ * anında duyurur. `info` ve `success` duyurulmaz — sayfa yüklenirken her bilgi
+ * kutusunun okunması gürültü olurdu.
+ */
+declare const Alert_2: FC<Props_12>;
+
+export declare type AlertTone = 'info' | 'success' | 'warning' | 'danger';
+
+export declare const Avatar: typeof Avatar_2;
+
+/**
+ * Avatar — kullanıcı madalyonu.
+ *
+ * <h3>Görsel yoksa baş harf</h3>
+ * Profil görseli olmayan bir sistemde baş harf madalyonu kimliği
+ * <em>yeterince</em> taşır: kullanıcı hesap menüsünün en üstünde doğru hesapta
+ * olduğunu görmek ister, fotoğrafını değil. `imageUrl` verildiğinde görsel
+ * çizilir ve baş harf yedeğe düşer; çağıran tarafların değişmesi gerekmez.
+ *
+ * <h3>Ekran okuyucuya okunmaz</h3>
+ * Madalyon `aria-hidden`: yanında zaten adın kendisi yazıyor. İkisini de
+ * okumak "A İ Ahmet İlhan" gibi bir gürültü üretiyordu. Adın yanında
+ * durmadığı bir yerde kullanılıyorsa çağıran taraf metni kendisi yazar.
+ */
+declare const Avatar_2: FC<Props_13>;
+
+export declare const Badge: typeof Badge_2;
+
+/**
+ * Rozet — durum ve sınıflandırma etiketi.
+ *
+ * <p><strong>Renk tek başına anlam taşımaz</strong> (WCAG 1.4.1): her rozet
+ * okunabilir bir metin içerir. `tone` yalnızca metni pekiştirir; renk körü bir
+ * kullanıcı da aynı bilgiyi alır.
+ *
+ * <h3>Durum tonlarında `solid` ile `soft` aynı şeyi verir</h3>
+ * Bu bilinçli. <strong>Doygun dolgu = tıklanabilir</strong> kuralı gereği dolu
+ * zeminli bir durum etiketi düğmeye benziyor ve kullanıcılar "Son 2 adet" gibi
+ * bir etikete tıklamayı deniyordu. Prop çağıran tarafları kırmamak için
+ * korundu, görünüm tint'e sabitlendi.
+ *
+ * <p>Doygun dolgu yalnızca <strong>miktar</strong> tonlarında (`action`,
+ * `link`) anlamlı: onlar bir durumu değil bir sayıyı bildirir ve tıklanabilir
+ * bir öğenin parçasıdır.
+ */
+declare const Badge_2: FC<Props_14>;
+
+export declare type BadgeTone = 'neutral' | 'success' | 'danger' | 'warning' | 'info'
+/** Birincil sınıflandırma tinti (mavi-lacivert aile). */
+| 'oem'
+/** İkincil sınıflandırma tinti (mor aile). */
+| 'alt'
+/** İndirim / olumlu değişim yüzdesi. Tutarın kendisi nötr kalır. */
+| 'sale'
+/** Miktar sayacı (sepet adedi, filtre sayısı) — dolu zemine izin verilir. */
+| 'action'
+/** Gezinme etiketi. */
+| 'link';
+
+export declare type BadgeVariant = 'soft' | 'solid' | 'outline';
+
+declare type BaseProps<T extends string> = {
+    options: ChipOption<T>[];
+    /** Grubun erişilebilir adı ("Sıralama", "Kalite"). */
+    label: string;
+    size?: ChipSize;
+    /** Taşan çipleri alta sarmak yerine yatay kaydırır (mobil filtre şeridi). */
+    isScrollable?: boolean;
+    className?: string;
+};
+
+declare type BaseProps_2 = {
+    label: string;
+    /** Girdi bileşenini alan `id` ve `aria-*` bağlarıyla üretir. */
+    children: (props: FieldChildProps) => ReactNode;
+    hint?: string;
+    error?: string;
+    /** Etiketi gizler ama ekran okuyucuya bırakır (arama kutusu gibi). */
+    isLabelHidden?: boolean;
+    className?: string;
+};
+
+declare type BaseProps_3 = {
+    isOpen: boolean;
+    /** Vazgeçme ve perde/Escape kapanışı. Başarı kapanışını bileşen kendisi yapar. */
+    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.
+     */
+    onSubmit: (value: string) => void | Promise<void>;
+    title: string;
+    /** Girdi alanının etiketi. */
+    label: string;
+    submitLabel: string;
+    cancelLabel: string;
+    /** 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).
+     */
+    inputMode?: 'text' | 'multiline' | 'number';
+    maxLength?: number;
+    rows?: number;
+};
+
+declare type BaseProps_4 = {
+    page: number;
+    totalPages: number;
+    /** Gezinme bölgesinin erişilebilir adı ("Sayfalar"). */
+    label: string;
+    previousLabel: string;
+    nextLabel: string;
+    className?: string;
+    testId?: string;
+};
+
+export declare const BottomSheet: MemoExoticComponent<({ title, closeLabel, onClose, children, toolbar, footer, closeAbove, className, testId, }: Props_28) => ReactPortal | null>;
+
+export declare const Breadcrumb: typeof Breadcrumb_2;
+
+/**
+ * Kırıntı yolu.
+ *
+ * <p>Son öğe bağlantı DEĞİL ve `aria-current="page"` taşır: bulunduğu sayfaya
+ * bağlantı veren bir kırıntı yolu, ekran okuyucu kullanıcısını yanıltır.
+ *
+ * <p>Ayırıcı ikon `aria-hidden`; ekran okuyucu liste yapısından hiyerarşiyi
+ * zaten anlar.
+ */
+declare const Breadcrumb_2: FC<Props_15>;
+
+/**
+ * Yapılandırmayı CSS metnine çevirir.
+ *
+ * <h3>Neden yalnızca EZİLEN token'lar yazılıyor</h3>
+ * Tam eşlemeyi yazmak da çalışırdı ama iki bedeli var: çıktı 90 satır yerine
+ * 4 satır olurdu ve daha önemlisi, kütüphane bir sonraki sürümde bir token'ın
+ * varsayılanını değiştirdiğinde tüketicinin sayfası ESKİ değeri yazmaya devam
+ * ederdi — üstelik ezmediği bir token için. Ezmeler ne ise o yazılır.
+ *
+ * <h3>Neden `<style>`, neden satır içi stil değil</h3>
+ * Satır içi stil yalnızca `<html>` üzerinde durur ve `[data-hanui-theme]`
+ * seçicisinden daha yüksek özgüllüktedir: kullanıcı temayı değiştirdiğinde
+ * ezmeler HER İKİ temada da aynı kalıyordu. Ayrı bir kural bloğu, açık ve
+ * koyu ezmeleri kendi seçicilerine bağlar.
+ */
+export declare const buildThemeCss: (config: HanuiThemeConfig) => string;
+
+export declare const Button: typeof Button_2;
+
+/**
+ * Düğme.
+ *
+ * <h3>Yüklenirken içerik korunur</h3>
+ * Metin dönen çarkla DEĞİŞTİRİLMEZ, yanına eklenir ve düğme genişliği
+ * sabitlenir. Metni değiştirmek düğmeyi daraltıp yerleşimi kaydırıyordu ve
+ * kullanıcı neye tıkladığını kaybediyordu.
+ *
+ * <h3>Bağlantı mı düğme mi</h3>
+ * `href` verilirse `<a>` çizilir. Görsel olarak düğme gibi duran bir
+ * bağlantının gerçekten `<a>` olması gerekir: orta tuşla yeni sekmede
+ * açılması ve tarayıcı geçmişine girmesi beklenen davranıştır.
+ *
+ * <p>`isExternal` ile birlikte yönlendirici DEĞİL ham `<a>` çizilir ve
+ * `target="_blank"` + `rel="noopener noreferrer"` eklenir. Uygulama dışı bir
+ * adres için yönlendiriciyi araya sokmak anlamsız; `rel` ise zorunlu —
+ * `noopener` olmadan açılan sekme `window.opener` üzerinden bu sayfaya
+ * erişebiliyor. Düğme benzeri dış bağlantı elle `<a>` olarak yazılmasın diye
+ * burada: elle yazılan her bağlantı odak halkasını ve durum matrisini yeniden
+ * kurmak zorunda kalıyordu.
+ *
+ * @example
+ * <Button variant={UIVariant.PRIMARY} isLoading={isSaving} onClick={save}>
+ *   Kaydet
+ * </Button>
+ */
+declare const Button_2: ForwardRefExoticComponent<Partial<{
+variant: UIVariant;
+size: UISize;
+isLoading: boolean;
+isFullWidth: boolean;
+startIcon: ReactNode;
+endIcon: ReactNode;
+}> & Partial<{
+className: string;
+id: string;
+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.
+*/
+isExternal?: boolean;
+/** Yönlendiriciye geçirilecek ek props (`{ scroll: false }`, `{ replace: true }`). */
+linkProps?: HanuiLinkExtraProps;
+} & RefAttributes<HTMLButtonElement>>;
+
+declare type ButtonProps = BaseProps_4 & {
+    /**
+     * Sayfa değişimi adres çubuğu YERİNE buraya bildirilir.
+     *
+     * <p>Yalnızca sayfalamanın adrese yazılmadığı listeler için: kişiye özel,
+     * `noindex` ekranlarda kimse "ikinci sayfa" bağlantısını paylaşmıyor ve orada
+     * adresi kirletmek geri tuşunu kullanılamaz hâle getiriyordu. Bağlantı
+     * verilebilecek bir hedef olmadığı için numaralar düğme kalır.
+     */
+    onPageChange: (page: number) => void;
+    buildHref?: never;
+    linkProps?: never;
+};
+
+export declare const Card: typeof Card_2;
+
+/**
+ * Kart — medya + gövde + eylem şeridi.
+ *
+ * <h3>Neden bileşik (compound) bir bileşen</h3>
+ * Bir uygulamadaki her kart (ürün, kampanya, sipariş) aynı üç bölümden oluşur
+ * ama içerikleri tamamen farklıdır. Tek bir "her şeyi yapan" kart bileşeni on
+ * beş isteğe bağlı prop'a şişiyordu. Bunun yerine <em>yerleşim</em>
+ * paylaşılır, içerik çağırana bırakılır: kenarlık, yarıçap, gölge, medya oranı
+ * ve eylem şeridinin dipte durması tek yerde tanımlıdır.
+ *
+ * <h3>Eylem şeridi hep dipte</h3>
+ * {@link CardFooter} `margin-top: auto` alır. Izgarada yan yana duran kartların
+ * başlıkları farklı uzunlukta olsa da alt şerit aynı hizada kalır; aksi hâlde
+ * satır dalgalı görünüyordu.
+ *
+ * @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>
+ */
+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. */
+export declare const CardFooter: FC<CardSectionProps>;
+
+/**
+ * Kartın görsel alanı.
+ *
+ * <p>Oran <strong>sabittir</strong>: görsel yüklenene kadar yer tutar ve
+ * yerleşim kaymasını (CLS) önler. Oransız bırakıldığında kartlar görseller
+ * yüklendikçe zıplıyordu.
+ */
+export declare const CardMedia: FC<CardMediaProps>;
+
+declare type CardMediaProps = {
+    children: ReactNode;
+    /** Genişlik / yükseklik oranı. Sabit oran yükleme sırasında kaymayı önler. */
+    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;
+    /** İçeriği kırpmak yerine sığdırır (şeffaf zeminli ürün fotoğrafları gibi). */
+    isContained?: boolean;
+    className?: string;
+};
+
+/**
+ * Görselin üzerine binen katman: rozetler ve hızlı eylemler.
+ *
+ * <p>Varsayılan olarak `pointer-events: none` — rozet yığını, altındaki görsel
+ * bağlantısının tıklanmasını engellememeli. İçindeki gerçek düğmeler kendi
+ * olaylarını geri açar.
+ */
+export declare const CardOverlay: FC<CardOverlayProps>;
+
+declare type CardOverlayProps = {
+    children: ReactNode;
+    position?: 'top-left' | 'top-right' | 'bottom-left' | 'bottom-right';
+    className?: string;
+};
+
+declare type CardProps = {
+    children: ReactNode;
+    /** Kartın tamamı bir hedefe götürüyorsa hover geri bildirimi açılır. */
+    isInteractive?: boolean;
+    /** Semantik etiket: liste öğesi kartları `article` olmalı. */
+    as?: ElementType;
+    className?: string;
+    testId?: string;
+};
+
+declare type CardSectionProps = {
+    children: ReactNode;
+    className?: string;
+};
+
+export declare const Checkbox: typeof Checkbox_2;
+
+/**
+ * Onay kutusu.
+ *
+ * <p>Yerel `<input type="checkbox">` korunur ve `accent-color` ile
+ * renklendirilir. Özel bir kutu çizmek (gizli input + sahte kare) klavye
+ * odağını ve ekran okuyucu davranışını elle yeniden kurmayı gerektirir;
+ * kazanç görsel, maliyet erişilebilirlik.
+ *
+ * <p>Tüm satır tıklanabilir (`<label>` sarmalar): 18 px'lik kareyi
+ * hedeflemek özellikle dokunmatik ekranda yorucu.
+ */
+declare const Checkbox_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
+label: ReactNode;
+hint?: string;
+testId?: string;
+} & RefAttributes<HTMLInputElement>>;
+
+export declare const Chip: typeof Chip_2;
+
+/**
+ * Çip — seçilebilir etiket.
+ *
+ * <h3>Tasarım sisteminin en çok tekrarlanan öğesi</h3>
+ * Kategori seçimi, hızlı filtre, sıralama tercihi, görünüm anahtarı: hepsi
+ * aynı öğe. Ayrı ayrı düğme stilleri yazmak yerine tek çip kullanılır;
+ * böylece seçili durumun nasıl göründüğü uygulamanın her yerinde aynıdır.
+ *
+ * <h3>Seçili durum üç sinyalle birden bildirilir</h3>
+ * Kenarlık + metin rengi + ikon rengi <em>birlikte</em> değişir. Yalnızca
+ * zemini doldurmak (renk tek başına, WCAG 1.4.1) renk körü kullanıcı için
+ * ayırt edilemez olurdu; ayrıca dolu zemin çipi düğmeye benzetip "buraya
+ * tıkla" gibi okutuyordu — oysa çip bir <em>durum</em> gösterir.
+ *
+ * <h3>Neden `aria-pressed`, `disabled` değil</h3>
+ * Seçili çip pasifleştirilmez: kullanıcı seçimini geri alabilmeli. Basılı
+ * düğme semantiği (`aria-pressed`) ekran okuyucuya "seçili, kapatılabilir"
+ * bilgisini verir.
+ */
+declare const Chip_2: ForwardRefExoticComponent<Omit<ButtonHTMLAttributes<HTMLButtonElement>, "children"> & {
+/** Görünen metin. Yalnız ikon taşıyan çipte verilmez; `label` zorunlu olur. */
+children?: ReactNode;
+/** Metnin solundaki ikon. */
+icon?: ReactNode;
+/** Metnin sağındaki ikon (ok, çarpı). */
+endIcon?: ReactNode;
+/** Sağda gösterilen sonuç adedi. */
+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.
+*/
+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.
+*/
+role?: "radio";
+testId?: string;
+} & RefAttributes<HTMLButtonElement>>;
+
+export declare const ChipGroup: typeof ChipGroup_2;
+
+/**
+ * Çip grubu — açılır liste yerine tek dokunuşla seçim.
+ *
+ * <h3>Ne zaman çip grubu, ne zaman açılır liste</h3>
+ * Seçenek sayısı azsa (kabaca 7'ye kadar) ve seçenekler ekranda durabiliyorsa
+ * çip grubu kullanılır: kullanıcı listeyi <em>açmadan</em> hem seçenekleri hem
+ * de hangisinin seçili olduğunu görür — açılır listede bu bilgi iki tıklama
+ * arkasındadır. 5–20 seçenek için {@link Select}, 20+ için {@link Combobox}.
+ *
+ * <h3>Tek seçim radyo grubudur</h3>
+ * Tek seçimli grup `role="radiogroup"` alır ve çipler `role="radio"` olur.
+ * Görsel olarak radyo düğmesi gibi durmasalar da davranış aynıdır; ekran
+ * okuyucu "3 seçenekten 2.'si" diye okur. Yalnız `aria-pressed` kullanmak,
+ * seçeneklerin birbirini dışladığı bilgisini kaybettiriyordu.
+ *
+ * <h3>Gezinme tabindex'i dolaşır (roving tabindex)</h3>
+ * Radyo grubunda Tab tuşu <strong>gruba</strong> girer, seçenekler arasında ok
+ * tuşlarıyla gezilir. Her çipin ayrı ayrı Tab durağı olması, 7 seçenekli bir
+ * filtrede klavye kullanıcısını 7 kez Tab'lamaya zorluyordu.
+ */
+declare const ChipGroup_2: <T extends string>({ options, label, size, isScrollable, className, ...selection }: Props_4<T>) => JSX.Element;
+
+export declare type ChipOption<T extends string = string> = {
+    value: T;
+    label: string;
+    icon?: ReactNode;
+    count?: number;
+    isDisabled?: boolean;
+};
+
+export declare type ChipSize = 'sm' | 'md';
+
+export declare const Combobox: typeof Combobox_2;
+
+/**
+ * Aranabilir seçim kutusu.
+ *
+ * <h3>Neden yerel `<select>` değil</h3>
+ * Yerel açılır liste 20 seçeneğe kadar iyidir. Binlerce seçenekli bir listede
+ * kullanıcı harf harf yazarak (ve yalnızca baştan eşleşerek) arıyor, mobilde
+ * ise metrelerce süren bir tekerlek çeviriyor. Aranabilir liste, seçeneği
+ * <em>yazarak</em> bulmayı mümkün kılar.
+ *
+ * <h3>Arama kutusu listenin İÇİNDE</h3>
+ * Arama alanını listenin dışına koymak kullanıcıya iki ayrı alan gösteriyor
+ * ve hangisinin seçimi belirlediği anlaşılmıyordu. Tek tetikleyici, tek
+ * panel: masaüstünde panel açılınca odak doğrudan arama kutusuna gider,
+ * yazılır, Enter'a basılır. Dar ekranda odak VERİLMEZ — bkz. aşağıdaki not.
+ *
+ * <h3>Yerel mi sunucu araması mı</h3>
+ * `onSearch` verilmezse bileşen elindeki listeyi aksan duyarsız filtreler.
+ * Verilirse filtrelemeyi <em>yapmaz</em> — sunucudan gelen liste zaten
+ * filtrelenmiştir; ikinci kez filtrelemek sunucunun daha akıllı eşleşmesini
+ * (eş anlamlı, kod eşleşmesi) bozardı.
+ *
+ * <h3>Seçilenin etiketi listeden düşse de korunur</h3>
+ * Sunucu aramasında kullanıcı yeni bir arama yaptığında seçili kayıt gelen
+ * listede olmayabilir. Etiket son bilinen değerden hatırlanır; aksi hâlde
+ * tetikleyici seçim varken yer tutucuya dönüyordu.
+ *
+ * <h3>Dar ekranda arama kutusu ODAKLANMAZ</h3>
+ * Alt sayfa açılırken kutuya odaklanmak ekran klavyesini kullanıcı istemeden
+ * açıyordu: panel yarı yüksekliğe sıkışıyor, liste birkaç satıra iniyor ve
+ * seçim yapmak için önce klavyeyi kapatmak gerekiyordu. Telefonda liste
+ * taranarak kullanılır; yazmak isteyen kutuya kendisi dokunur.
+ *
+ * <h3>ARIA</h3>
+ * Tetikleyici `aria-haspopup="listbox"`, panel içindeki arama alanı
+ * `role="combobox"` + `aria-activedescendant`. Masaüstünde odak arama
+ * kutusundan ayrılmaz; ok tuşları yalnızca <em>etkin</em> seçeneği değiştirir.
+ * Odağı seçeneklere taşımak, yazmaya devam etmeyi imkânsız kılıyordu.
+ */
+declare const Combobox_2: <T extends string>({ options, value, onChange, labels, isSearchHidden, onSearch, isLoading, isDisabled, isClearable, icon, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_5<T>) => JSX.Element;
+
+/** Bileşenin çizdiği metinler. Hepsi ZORUNLU: kütüphane dil kararı vermez. */
+export declare type ComboboxLabels = {
+    /** Seçim yokken tetikleyicide ve alt sayfa başlığında görünen metin. */
+    placeholder: string;
+    /** Arama kutusunun yer tutucusu ve erişilebilir adı. */
+    searchPlaceholder: string;
+    /** Liste boşken gösterilen metin. */
+    emptyMessage: string;
+    /** Arama sürerken liste yerine gösterilen metin. */
+    loadingMessage: string;
+    /** Seçimi kaldıran çarpının erişilebilir adı. */
+    clearLabel: string;
+    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. */
+    closeLabel: string;
+};
+
+export declare type ComboboxOption<T extends string = string> = {
+    value: T;
+    label: string;
+    /** İkincil satır: kod, numara, ayırt edici bilgi. */
+    description?: string;
+    isDisabled?: boolean;
+};
+
+/**
+ * Her bileşenin kabul ettiği ortak kanca noktaları.
+ *
+ * <p>`testId` `data-testid` olarak çizilir. Test kancasını prop olarak
+ * geçirmek yerine `className`e bir işaret koymak da mümkündü ama sınıf adları
+ * derleme sırasında karıştırılıyor: testin ona tutunması, kütüphane sürüm
+ * atladığında sessizce kopuyordu.
+ */
+export declare type CommonElementProps = Partial<{
+    className: string;
+    id: string;
+    testId: string;
+}>;
+
+export declare const ConfirmDialog: typeof ConfirmDialog_2;
+
+/**
+ * Onay penceresi.
+ *
+ * <h3>Neden `window.confirm()` yerine bu</h3>
+ * Yerel `confirm()`in dört sorunu var:
+ * <ul>
+ *   <li>Görünümü işletim sisteminin — sitenin diliyle hiç ilgisi yok, üstünde
+ *       tarayıcının alan adı yazıyor.</li>
+ *   <li><strong>Ana iş parçacığını kilitler.</strong></li>
+ *   <li>Yıkıcı eylemi vurgulayamaz: "Tamam" ile "İptal" aynı ağırlıkta ve
+ *       hangisinin sildiğini yalnızca metinden anlıyorsun.</li>
+ *   <li>İstek sürerken geri bildirim veremez; kullanıcı silme düğmesine ikinci
+ *       kez basıyordu.</li>
+ * </ul>
+ *
+ * <h3>Yükleme durumu pencerede kalır</h3>
+ * Onaya basıldığında pencere hemen kapanmaz: düğme yükleniyor durumuna geçer
+ * ve pencere kapanmaz hâle gelir (`isDismissable={false}`). İstek bittiğinde
+ * kapatma kararı çağırana ait — hata varsa pencere açık kalmalı ki kullanıcı
+ * tekrar deneyebilsin.
+ *
+ * @example
+ * const [target, setTarget] = useState<Address | null>(null);
+ *
+ * <ConfirmDialog
+ *   isOpen={target !== null}
+ *   onClose={() => setTarget(null)}
+ *   kind="destructive"
+ *   title="Adres silinsin mi?"
+ *   description="Bu işlem geri alınamaz."
+ *   confirmLabel="Sil"
+ *   cancelLabel="Vazgeç"
+ *   closeLabel="Kapat"
+ *   onConfirm={async () => {
+ *     await remove(target!.id);
+ *     setTarget(null);
+ *   }}
+ * />
+ */
+declare const ConfirmDialog_2: FC<Props_30>;
+
+export declare type ConfirmKind = 'destructive' | 'warning' | 'neutral';
+
+export declare const CopyField: typeof CopyField_2;
+
+/**
+ * Kopyalanabilir teknik değer — <strong>tek dokunuşla panoya</strong>.
+ *
+ * <h3>Neden ayrı bir öğe</h3>
+ * Bir kod (SKU, parça numarası, sipariş numarası, IBAN) dekoratif bir metin
+ * değil, kullanıcının <em>taşıdığı</em> veri. Düz bir `<span>` olduğunda
+ * kullanıcı onu fareyle seçmeye çalışırken kartın tamamını seçiyor ya da
+ * yanlışlıkla altındaki bağlantıyı tetikliyordu.
+ *
+ * <h3>Neden monospace</h3>
+ * "0986479644" gibi diziler orantılı yazı tipinde okunmuyor: `0`/`O` ve `1`/`l`
+ * ayırt edilemiyor ve bir hane atlandığında tamamen başka bir kayıt oluyor.
+ * `technical-text` sabit genişlik + `tabular-nums` verir; iki değer alt alta
+ * geldiğinde farklı hane gözle bulunur.
+ *
+ * <h3>Geri bildirim neden düğmenin üstünde</h3>
+ * Bir bildirim (toast) da olurdu ama listelerde on beş satır var; ekranın
+ * dibinde "kopyalandı" yazması <em>hangisinin</em> kopyalandığını
+ * söylemiyordu. İkon yerinde tike dönünce cevap tıklanan yerde.
+ *
+ * <h3>Pano erişimi reddedilirse</h3>
+ * `navigator.clipboard` güvenli olmayan bağlamda (HTTP) ve izin verilmediğinde
+ * reddeder. O durumda değer sessizce <em>seçilir</em>: kullanıcı Ctrl+C ile
+ * kendisi kopyalayabilir. Sessizce hiçbir şey yapmamak, düğmeyi bozuk
+ * gösteriyordu.
+ */
+declare const CopyField_2: FC<Props_16>;
+
+export declare type Crumb = {
+    label: string;
+    /** Son öğede verilmez: bulunduğumuz sayfa bağlantı olmaz. */
+    href?: string;
+};
+
+/**
+ * KOYU TEMA.
+ *
+ * <p>Yüzey merdiveni açık temanın AYNISI DEĞİL, tersi: koyu temada yükselen
+ * yüzey AÇILIR (`surface` > `page`), çünkü ışık yukarıdan gelir. Aynı sırayı
+ * korumak kartları sayfaya gömüyordu.
+ */
+export declare const DARK_THEME: Record<keyof typeof LIGHT_THEME, string>;
+
+export declare const DataTable: typeof DataTable_2;
+
+/**
+ * Operasyon veri tablosu — durum satırlı tablo sözleşmesi.
+ *
+ * <h3>Neden bir bileşen</h3>
+ * On iki ekranda on bir ham tablo ve altı kaydırma sarmalayıcısı kopyası
+ * vardı; üçü farklı davranıyordu (kimi dikey kaymıyor, kiminin başlığı
+ * yapışmıyor). Kabuk (yüzey + hairline + `overflow: auto`), tablo görünümü ve
+ * üç durum satırı (yükleniyor / hata / boş) artık tek yerde; `colSpan` sütun
+ * sayısından kendiliğinden hesaplanır — elle yazılan `colSpan={8}` bir sütun
+ * eklenince sessizce yanlış kalıyordu.
+ *
+ * <h3>Durum öncelik sırası</h3>
+ * `error` &gt; `isLoading` &gt; boş &gt; satırlar. Hata varken yükleme veya boş
+ * mesajı gösterilmez; yüklenirken bayat satır çizilmez.
+ */
+declare const DataTable_2: FC<Props_33>;
+
+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. */
+    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.
+     */
+    srLabel?: string;
+    /**
+     * Sıralanabilir sütunun yönü (`aria-sort`). Sıralama düğmesi `label` içinde
+     * yaşar; yön bilgisi ekran okuyucu için başlık hücresine yazılır.
+     */
+    ariaSort?: 'ascending' | 'descending';
+    className?: string;
+};
+
+export declare const DataTableRow: FC<RowProps>;
+
+/** Kütüphanenin varsayılan font yığınları — hepsi sistem fontlarına iner. */
+export declare const DEFAULT_FONTS: Required<HanuiFonts>;
+
+export declare const Directory: typeof Directory_2;
+
+/**
+ * Dizin — harf veya konu başlıklı, gruplanmış bağlantı listesi.
+ *
+ * <h3>Neden ortak bir bileşen</h3>
+ * Bir marka dizini ile bir kategori dizini aynı işi yapıyor: yüzlerce
+ * bağlantıyı gruplayıp taranabilir kılmak. Ama iki container bunu ayrı ayrı
+ * kurmuştu ve sonuç iki farklı sayfa oldu — birinde grup başlığı alt çizgili
+ * 19 px, diğerinde çizgisiz; birinde satırlar ızgarada, diğerinde tek kolonda.
+ *
+ * <p>Ortak olan <em>görsel dilbilgisi</em>: grup başlığı + ızgara + satır
+ * öğesi. O buraya taşındı; ne listelendiği çağırana kaldı.
+ *
+ * @example
+ * <Directory>
+ *   <DirectoryGroup label="A">
+ *     <DirectoryRow href="/marka/ate" name="ATE" media={<img … />} />
+ *   </DirectoryGroup>
+ * </Directory>
+ */
+declare const Directory_2: FC<DirectoryProps>;
+
+/**
+ * Dizin grubu.
+ *
+ * <p>Başlık <strong>yapışkan</strong>: uzun bir listede kaydırırken hangi
+ * harfte olduğunu görmek, listeyi yukarı sarıp kontrol etmekten iyi.
+ */
+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.
+     */
+    href?: string;
+    /** Yönlendiriciye geçirilecek ek props. */
+    linkProps?: HanuiLinkExtraProps;
+    /** Başlığın sağında duran sayaç ("14 alt kategori"). */
+    meta?: ReactNode;
+    children: ReactNode;
+    /** Çıpa hedefi: alfabe şeridinden atlamak için. */
+    id?: string;
+};
+
+/**
+ * Alfabe atlama şeridi.
+ *
+ * <p>Uzun bir listede "V" harfine ulaşmak için kaydırmak dakikalar alıyordu.
+ * Şerit yatay kayar ve `#çıpa` bağlantıları taşır — JavaScript gerekmez,
+ * tarayıcı kaydırmayı kendisi yapar ve bağlantı paylaşılabilir.
+ *
+ * <p>Bağlantılar HAM `<a>`: bunlar sayfa içi çıpa, gezinme değil. Bir
+ * yönlendiriciden geçirmek aynı sayfayı yeniden çözümleyip kaydırmayı
+ * kaçırıyordu.
+ */
+export declare const DirectoryJump: FC<DirectoryJumpProps>;
+
+declare type DirectoryJumpProps = {
+    /** Grup etiketleri; her biri kendi çıpasına bağlanır. */
+    labels: string[];
+    /** Çıpa kimliğini üretir; `DirectoryGroup id` ile aynı olmalı. */
+    toId: (label: string) => string;
+    /** Şeridin erişilebilir adı ("Harfe göre atla"). */
+    label: string;
+};
+
+declare type DirectoryProps = {
+    children: ReactNode;
+    className?: string;
+};
+
+/**
+ * Dizin satırı — tek bir bağlantı.
+ *
+ * <p>Tüm satır tıklanabilir ve en az 44 px yüksekliğinde (WCAG 2.5.8):
+ * yalnızca metnin tıklanabilir olduğu bir listede dokunmatik kullanıcılar
+ * satırın boşluğuna basıp hiçbir şey olmadığını görüyordu.
+ */
+export declare const DirectoryRow: FC<DirectoryRowProps>;
+
+declare type DirectoryRowProps = {
+    href: string;
+    name: string;
+    /** Logo, ikon veya baş harf madalyonu. Satırın solunda. */
+    media?: ReactNode;
+    /** Sağ uçta duran işaret: rozet, kayıt sayısı. */
+    marker?: ReactNode;
+    /** Yönlendiriciye geçirilecek ek props. */
+    linkProps?: HanuiLinkExtraProps;
+    className?: string;
+};
+
+export declare const Divider: typeof Divider_2;
+
+/**
+ * Ayırıcı çizgi.
+ *
+ * <p>Etiketli hâli `role="separator"` taşımaz: metin içerdiğinde ekran okuyucu
+ * onu ayırıcı değil içerik olarak okumalı ("veya").
+ */
+declare const Divider_2: FC<Props_17>;
+
+export declare const EmptyState: typeof EmptyState_2;
+
+/**
+ * Boş durum.
+ *
+ * <h3>Neden her boş durum bir eylem taşır</h3>
+ * "Sonuç bulunamadı" tek başına çıkmaz sokaktır. Kullanıcı o ekranda ne
+ * yapacağını bilmeli: aramayı temizle, filtreyi kaldır, listeye dön. `action`
+ * isteğe bağlı ama çağıran taraf onu vermezse kullanıcı tıkanır.
+ *
+ * <p>Bir listenin BOŞ olması ile YÜKLENEMEMESİ ayrı durumlardır: ağ hatasında
+ * bu bileşen çizilmez, hata kendi mesajıyla gösterilir. İkisini birleştirmek
+ * kullanıcıya "kayıt kalmamış" dedirtiyordu.
+ */
+declare const EmptyState_2: FC<Props_18>;
+
+export declare const Field: typeof Field_2;
+
+/**
+ * Form alanı sarmalayıcısı.
+ *
+ * <h3>Neden render-prop</h3>
+ * Etiket, hata mesajı ve yardım metni girdiye `id` / `aria-describedby` /
+ * `aria-invalid` ile <strong>bağlanmak zorunda</strong> — yoksa ekran okuyucu
+ * hatayı okumaz. Bu bağları her form alanında elle yazmak kaçınılmaz olarak
+ * bir yerde atlanıyor.
+ *
+ * <p>Render-prop kalıbı bağları bileşene ürettirir: çağıran taraf yalnızca
+ * aldığı props'ları girdiye yayar ve erişilebilirlik kendiliğinden doğru olur.
+ *
+ * <p>Hata varken yardım metni gösterilmez: ikisi birlikte gürültü yapar ve
+ * kullanıcının okuması gereken mesaj kaybolur.
+ *
+ * @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>
+ */
+declare const Field_2: FC<Props_11>;
+
+/** Girdiye yayılacak erişilebilirlik bağları. */
+export declare type FieldChildProps = {
+    id: string;
+    'aria-invalid'?: boolean;
+    'aria-describedby'?: string;
+    required?: boolean;
+};
+
+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.
+     */
+    isWide?: boolean;
+    className?: string;
+};
+
+export declare const FilterBar: typeof FilterBar_2;
+
+/**
+ * Filtre şeridi.
+ *
+ * <h3>Her zaman `<form onSubmit>`</h3>
+ * Beş ekran şeridi elle kuruyordu ve yalnızca üçü `<form>` kullanıyordu: arama
+ * kutusunda Enter üç ekranda filtreyi uyguluyor, ikisinde hiçbir şey
+ * yapmıyordu. Şerit artık her zaman bir formdur ve görünür bir gönderme düğmesi
+ * olmasa bile Enter çalışsın diye gizli bir yedek gönderme düğmesi taşır
+ * (birden çok alanı olan formda tarayıcının örtük gönderimi ancak bir gönderme
+ * düğmesi varsa çalışır).
+ *
+ * <h3>320px'te taşma yok</h3>
+ * Alanlar `min-width: 240–280px` taşıyordu ve en dar ekranda şerit sayfayı yana
+ * kaydırıyordu. Genişlik artık `flex-basis` ile istenir, `min-width: 0` ile
+ * daraltılabilir kalır: alan tercihen 220px'tir ama sığmadığı yerde küçülür,
+ * taşmaz.
+ */
+declare const FilterBar_2: FC<Props_34>;
+
+/**
+ * Ş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.
+ */
+export declare const FilterBarField: FC<FieldProps>;
+
+/** Kullanıcının seçtiği tema. `system` işletim sistemi tercihini izler. */
+export declare type HanuiColorScheme = 'light' | 'dark';
+
+export declare type HanuiContextValue = {
+    /**
+     * Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…).
+     *
+     * <p>Verilmezse ham `<a>` çizilir ve gezinme tam sayfa yenilemesi olur.
+     * Bir bileşen kütüphanesi kendi yönlendiricisini SEÇEMEZ: `next/link`
+     * import etmek paketi Next'e bağlar, `react-router` import etmek başka bir
+     * uygulamayı kırar. Karar tüketicinin.
+     */
+    linkComponent?: HanuiLinkComponent;
+    /** Uygulanan tema ezmeleri. Salt okunur; değiştirmek için `HanuiProvider`. */
+    theme?: HanuiThemeConfig;
+};
+
+/**
+ * Yazı tipi ailesi sözleşmesi.
+ *
+ * <p>Üç rol ayrı: başlık (≥19 px), arayüz metni (11–16 px) ve teknik veri
+ * (kod, seri numarası, tutar). KÜÇÜK ARAYÜZ METNİ BAŞLIK FONTUNU KULLANMAZ —
+ * grotesk başlık yüzleri 12–14 px yarı-kalında sıkışıp okunurluğu düşürüyor
+ * ve düğme etiketleri bir arayüzün en çok okunan kısa metinleri.
+ *
+ * <p>Kütüphane font YÜKLEMEZ: değerler `font-family` dizesi olarak geçer ve
+ * yüklemeyi (next/font, @font-face, CDN) tüketici yapar. Bir UI paketinin
+ * ağdan font çekmesi, tüketicinin ölçemediği bir istek demek.
+ */
+export declare type HanuiFonts = Partial<{
+    heading: string;
+    body: string;
+    mono: string;
+}>;
+
+/** Tüketicinin yönlendiricisi (`next/link`, `react-router`ın `Link`i…). */
+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 }} … />
+ */
+export declare type HanuiLinkExtraProps = Record<string, unknown>;
+
+/**
+ * Kütüphanenin bir bağlantı bileşenine geçirdiği props.
+ *
+ * <p>`href` dize: yönlendirici nesnesi (`UrlObject`) alan bir Link'e de dize
+ * geçilebiliyor, tersi doğru değil. En dar sözleşme en çok yönlendiriciyle
+ * uyumlu olan.
+ *
+ * <p>İndeks imzası yönlendiriciye özgü ek props içindir (Next'in `scroll`,
+ * `prefetch`i; React Router'ın `replace`i). Kütüphane onları tanımıyor ama
+ * yolunu da kapatmamalı. Değer tipi `unknown`, `any` DEĞİL: `any` yazmak
+ * yanlış bir prop'un tip denetiminden sessizce geçmesine izin verirdi.
+ * `href` ve `children` açıkça bildirildiği için indeks imzasından etkilenmez.
+ */
+export declare type HanuiLinkProps = AnchorHTMLAttributes<HTMLAnchorElement> & {
+    href: string;
+    children?: ReactNode;
+    [key: string]: unknown;
+};
+
+/**
+ * Kütüphane sağlayıcısı.
+ *
+ * <h3>İki iş yapar, üçüncüsünü YAPMAZ</h3>
+ * <ol>
+ *   <li>Tema ezmelerini belgeye yazar (`<style id="hanui-theme-overrides">`).</li>
+ *   <li>Yönlendirici bileşenini bileşen ağacına dağıtır.</li>
+ *   <li><strong>Açık/koyu seçimini YÖNETMEZ.</strong></li>
+ * </ol>
+ *
+ * <h3>Neden tema seçimi burada değil</h3>
+ * Seçim `<html data-hanui-theme>` üzerinde taşınır ve o özniteliğin
+ * <em>boyamadan önce</em> yazılması gerekir: React ağacı monte olduktan sonra
+ * yazıldığında koyu tema seçmiş kullanıcı bir kare beyaz ekran görüyor. Doğru
+ * yer, sunucudan gelen HTML'in `<head>`ine konan satır içi bir betik — ve
+ * oraya yazmak tüketicinin çatısının işi (Next'te `app/layout.tsx`, Vite'ta
+ * `index.html`). Sağlayıcı ondan sonra monte oluyor; oraya koymak sorunu
+ * çözmüyor, gizliyor.
+ *
+ * <p>`useHanuiTheme` kancası seçimi <em>değiştirmek</em> için var; ilk değeri
+ * yazmak için değil. README "Tema" bölümünde hazır betik duruyor.
+ *
+ * @example
+ * <HanuiProvider linkComponent={NextLink} theme={{ light: { blue: '#0d6efd' } }}>
+ *   <App />
+ * </HanuiProvider>
+ */
+export declare const HanuiProvider: FC<Props>;
+
+/** Bir temanın TAM eşlemesi. */
+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' },
+ *   },
+ * });
+ */
+export declare type HanuiThemeConfig = Partial<{
+    light: HanuiThemeTokens;
+    dark: HanuiThemeTokens;
+    fonts: HanuiFonts;
+}>;
+
+/** Bir temanın token → değer eşlemesi. Kısmî verilebilir; eksikler varsayılandan gelir. */
+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;
+
+export declare const IconButton: typeof IconButton_2;
+
+/**
+ * Yalnızca ikon taşıyan düğme.
+ *
+ * <p>`label` <strong>zorunlu</strong>: görsel etiketi olmayan bir düğme
+ * `aria-label` olmadan ekran okuyucuda "düğme" diye okunur. Zorunlu tutmak,
+ * unutulmasını derleme zamanında engeller.
+ *
+ * <p>Dokunma hedefi 44×44 px'ten küçük olamaz (WCAG 2.5.8) — görsel kutu daha
+ * küçük olsa bile tıklanabilir alan korunur.
+ *
+ * <h3>`href` verilince `<a>` çizilir</h3>
+ * Bir tablo satırının "düzenle" simgesi görsel olarak düğme ama davranışı
+ * bağlantı: orta tuşla yeni sekmede açılması, adresinin kopyalanabilmesi ve
+ * tarayıcı geçmişine girmesi beklenen davranış. `onClick` + `router.push` ile
+ * yazıldığında bunların hiçbiri çalışmıyordu.
+ *
+ * <p>Bağlantı kipinde `disabled` YOKTUR — `<a>` etiketinin devre dışı hâli
+ * yok ve `aria-disabled` tıklamayı engellemez. Erişilemez olması gereken bir
+ * eylem hiç çizilmez.
+ */
+declare const IconButton_2: ForwardRefExoticComponent<ButtonHTMLAttributes<HTMLButtonElement> & {
+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`.
+*/
+variant?: IconButtonVariant;
+size?: "sm" | "md";
+/** Verilirse öğe bir bağlantı olarak çizilir. */
+href?: string;
+/** Yönlendiriciye geçirilecek ek props. */
+linkProps?: HanuiLinkExtraProps;
+testId?: string;
+} & RefAttributes<HTMLButtonElement>>;
+
+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.
+ *
+ * <h3>Ne zaman bu, ne zaman `HanuiProvider`</h3>
+ * `HanuiProvider` React'in içinde yaşıyor ve yönlendirici bileşenini de
+ * taşıyor — normal yol o. Bu fonksiyon iki durum için:
+ *
+ * <ul>
+ *   <li><strong>Boyamadan önce çalışması gereken tema.</strong> Sağlayıcı
+ *       ağaç monte olduktan sonra yazıyor; koyu tema seçmiş bir kullanıcı o
+ *       ana kadar beyaz ekran görüyor. `<head>` içindeki satır içi bir
+ *       betikten çağrıldığında ezmeler ilk boyamadan önce yerinde olur.</li>
+ *   <li><strong>React kullanmayan bir kabuk.</strong> Tasarım token'ları
+ *       yalnızca CSS; bir e-posta önizlemesi ya da Storybook temasında
+ *       bileşen ağacı olmadan da gerekiyor.</li>
+ * </ul>
+ *
+ * <p>İkisi birlikte kullanılabilir: aynı `<style>` etiketini paylaşırlar ve
+ * son çağrı kazanır.
+ *
+ * @example
+ * // app/layout.tsx — <head> içine, boyamadan önce.
+ * <script dangerouslySetInnerHTML={{ __html: `
+ *   document.documentElement.dataset.hanuiTheme =
+ *     localStorage.getItem('theme') ?? 'light';
+ * ` }} />
+ */
+export declare const initHanui: (options?: InitHanuiOptions) => void;
+
+export declare type InitHanuiOptions = Partial<{
+    /** Tema ezmeleri. Yalnızca değiştirilen token'lar verilir. */
+    theme: HanuiThemeConfig;
+    /**
+     * Başlangıç şeması. Verilmezse `<html data-hanui-theme>` neyse o kalır;
+     * o da yoksa sistem tercihi (`prefers-color-scheme`) devreye girer.
+     */
+    colorScheme: HanuiColorScheme;
+}>;
+
+export declare const Input: typeof Input_2;
+
+/**
+ * Metin girdisi.
+ *
+ * <p>Ön ek / son ek girdinin <em>içinde</em> konumlanır; girdinin yanına ayrı
+ * bir kutu koymak hizalamayı bozar ve odak halkasını ikiye böler.
+ *
+ * <p>Odak halkası sarmalayıcıda değil girdinin kendisinde: sarmalayıcıya
+ * verildiğinde `:focus-visible` klavye/fare ayrımını kaybediyordu.
+ */
+declare const Input_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "prefix"> & {
+/** Solda gösterilen ikon veya ön ek (arama simgesi, para birimi). */
+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ı. */
+isTechnical?: boolean;
+testId?: string;
+} & RefAttributes<HTMLInputElement>>;
+
+/** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */
+export declare const isKeyboardOpeningElement: (element: Element | null) => boolean;
+
+/**
+ * AÇIK TEMA — varsayılan.
+ *
+ * <p>Bilgi yoğunluğu yüksek ekranlarda açık zeminde okunurluk daha yüksek.
+ */
+export declare const LIGHT_THEME: {
+    readonly page: "#f6f7f9";
+    readonly surface: "#ffffff";
+    readonly 'surface-2': "#eef0f4";
+    readonly 'surface-3': "#e7eaef";
+    readonly 'surface-inset': "#fafbfc";
+    readonly border: "#d6dce4";
+    readonly 'border-strong': "#c9d0da";
+    readonly text: "#11151b";
+    readonly 'text-2': "#5a6472";
+    readonly 'text-3': "#6b7583";
+    readonly graphite: "#1f2937";
+    readonly 'graphite-2': "#2b3646";
+    readonly 'graphite-3': "#3a4658";
+    readonly action: "#1f2937";
+    readonly 'action-hover': "#2b3646";
+    readonly 'action-active': "#3a4658";
+    readonly 'on-action': "#ffffff";
+    /** Pasif dolgu; saydamlık DEĞİL kendi rengi (bkz. Button `:disabled`). */
+    readonly 'action-soft': "#c9d0da";
+    readonly amber: "#f59e0b";
+    readonly 'amber-hover': "#d98706";
+    readonly 'amber-active': "#b87205";
+    readonly 'amber-soft': "#f8cd80";
+    readonly 'on-amber': "#291500";
+    readonly blue: "#2f6fed";
+    readonly 'blue-hover': "#1d54c4";
+    readonly 'blue-active': "#17439c";
+    readonly 'blue-text': "#1d54c4";
+    readonly 'blue-tint': "#eaf1fe";
+    readonly 'blue-line': "#bcd2fb";
+    readonly 'ok-bg': "#e8f4eb";
+    readonly 'ok-fg': "#1d6e31";
+    readonly 'ok-line': "#a8dcb7";
+    readonly 'warn-bg': "#fdf0dd";
+    readonly 'warn-fg': "#7a3e02";
+    readonly 'warn-line': "#ebc687";
+    readonly 'off-bg': "#f1f2f5";
+    readonly 'off-fg': "#3a424f";
+    readonly 'off-line': "#ccd2db";
+    readonly 'bad-bg': "#f8ebeb";
+    readonly 'bad-fg': "#bb1e1e";
+    readonly 'bad-line': "#e6a6a6";
+    readonly 'oem-bg': "#eaf1fe";
+    readonly 'oem-fg': "#16305c";
+    readonly 'oem-line': "#a9c6f9";
+    readonly 'alt-bg': "#eeebfa";
+    readonly 'alt-fg': "#2e2661";
+    readonly 'alt-line': "#c0b6ea";
+    readonly 'sale-bg': "#e8f4eb";
+    readonly 'sale-fg': "#1d6e31";
+    readonly 'red-accent': "#dc2626";
+    readonly 'green-accent': "#34c759";
+    readonly 'green-accent-hover': "#2aae4b";
+    readonly 'on-green': "#06280f";
+    readonly star: "#9a5f04";
+    readonly 'danger-solid': "#dc2626";
+    readonly 'danger-solid-hover': "#bb1e1e";
+    readonly 'on-danger': "#ffffff";
+    readonly 'nav-bg': "#ffffff";
+    readonly 'nav-bg-2': "#eef0f4";
+    readonly 'nav-fg': "#11151b";
+    readonly 'nav-fg-2': "#5a6472";
+    readonly 'nav-fg-3': "#8a94a3";
+    readonly 'nav-line': "#e2e6ec";
+    readonly 'nav-line-strong': "#c9d0da";
+    readonly 'nav-hover': "#eef0f4";
+    readonly 'footer-bg': "#eef0f4";
+    readonly 'shadow-xs': `0 1px 2px ${string}`;
+    readonly 'shadow-sm': `0 1px 2px ${string}, 0 1px 3px ${string}`;
+    readonly 'shadow-md': `0 2px 4px ${string}, 0 6px 16px ${string}`;
+    readonly 'shadow-lg': `0 4px 8px ${string}, 0 16px 32px ${string}`;
+    readonly 'shadow-xl': `0 8px 16px ${string}, 0 28px 56px ${string}`;
+    /** Yapışkan alt bar; gölge YUKARI düşer. */
+    readonly 'shadow-up': `0 -2px 4px ${string}, 0 -8px 24px ${string}`;
+    /** Odak halkası MAVİ: odak bir gezinme olayıdır, bir dönüşüm değil. */
+    readonly ring: `0 0 0 3px ${string}`;
+    readonly 'ring-color': "#2f6fed";
+    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': "#eef0f4";
+    readonly 'skeleton-b': "#fafbfc";
+    readonly track: string;
+    /** Görsel yer tutucu (medya yoksa). */
+    readonly 'media-bg': "#eef0f4";
+    readonly 'glow-1': string;
+    readonly 'glow-2': string;
+    readonly 'glow-amber': string;
+};
+
+declare type LinkProps = BaseProps_4 & {
+    /**
+     * Sayfa numarasının adresini üretir.
+     *
+     * <p>Verildiğinde numaralar `<a>` olur — ve olması gerekir. Düğmenin `href`i
+     * yok: arama motoru bir tıklama olayını çalıştırmaz ve ikinci sayfaya HİÇ
+     * geçemez; kullanıcı da orta tuşla yeni sekmede açamaz, adresi kopyalayamaz,
+     * durum çubuğunda hedefi göremez.
+     */
+    buildHref: (page: number) => string;
+    onPageChange?: never;
+    /** Yönlendiriciye geçirilecek ek props (`{ scroll: false }` gibi). */
+    linkProps?: HanuiLinkExtraProps;
+};
+
+/**
+ * Aranan metin, hedefin içinde geçiyor mu?
+ *
+ * <p>Aramanın tek kapısı burasıdır: her liste kendi `includes` çağrısını
+ * yazdığında biri normalizasyonu atlıyor ve o listede aksanlı arama
+ * çalışmıyordu.
+ */
+export declare const matchesSearch: (haystack: string, needle: string) => boolean;
+
+/**
+ * Kırılma noktaları — `styles/_variables.scss` içindeki `$breakpoint-*` ile
+ * <strong>aynı</strong> değerler.
+ *
+ * <p>Kararı normalde CSS verir; bu sabitler yalnızca <em>JavaScript'in de
+ * bilmek zorunda olduğu</em> tek durum için var: kipsel bir panel
+ * (`<dialog>`) açıkken pencere büyütüldüğünde. `showModal()` sayfanın geri
+ * kalanını inert bırakır ve bu, panelin çizilip çizilmediğine değil kipsel
+ * olmasına bağlıdır — CSS onu gizlese bile sayfa tıklanamaz kalır. Panel bu
+ * yüzden kırılma noktası aşıldığında JavaScript ile kapatılır.
+ *
+ * <p>Değerler iki yerde durduğu için ayrışabilir. Ayrışırlarsa panel yanlış
+ * genişlikte kapanır; CSS tarafı her zaman kazanır, buradaki değer ona
+ * uydurulur.
+ */
+export declare const MOBILE_BREAKPOINT = 640;
+
+export declare const Modal: typeof Modal_2;
+
+/**
+ * Kip pencere (modal).
+ *
+ * <h3>Yerel `<dialog>` + `showModal()`</h3>
+ * Odak tuzağı, Escape ile kapanma, arka planın etkileşime kapanması ve
+ * `aria-modal` semantiği tarayıcıdan gelir. Bunları `<div>` üzerine elle
+ * kurmak yüzlerce satır ve kaçınılmaz olarak eksik bir odak yönetimi demek.
+ *
+ * <h3>Neden `open` özniteliği değil `showModal()`</h3>
+ * `<dialog open>` pencereyi <em>kipsiz</em> açar: arka plan tıklanabilir kalır
+ * ve odak tuzağı çalışmaz. Kipli davranışın tek yolu yöntemi çağırmak.
+ *
+ * <h3>Arka planın kaydırılması ayrıca engellenir</h3>
+ * `showModal()` arka planı <em>etkileşime</em> kapatır ama tarayıcıların bir
+ * kısmında sayfa hâlâ kaydırılabiliyor: kullanıcı pencereyi kaydırdığını
+ * sanırken arkadaki listeyi kaydırıyordu. `<body>` kilitlenir.
+ *
+ * <h3>Mobilde alt sayfaya düşer</h3>
+ * Dar ekranda ortalanmış bir pencere, klavye açıldığında yukarı sıkışıyor ve
+ * dip düğmeleri klavyenin altında kalıyordu. Alt sayfa baş parmağın
+ * erişebildiği yerde durur.
+ */
+declare const Modal_2: ({ isOpen, onClose, title, closeLabel, children, description, footer, icon, tone, size, isDismissable, className, testId, }: Props_29) => JSX.Element;
+
+export declare type ModalTone = 'neutral' | 'danger' | 'warning' | 'success' | 'info';
+
+declare type MultipleProps<T extends string> = BaseProps<T> & {
+    isMultiple: true;
+    value: T[];
+    onChange: (value: T[]) => void;
+};
+
+/**
+ * Serbest metin arama anahtarı: ASCII, küçük harf, tek boşlukla ayrılmış.
+ *
+ * <h3>Neden aksan sökülüyor</h3>
+ * Kullanıcı "sisli" yazdığında "Şişli" bulunmalı. Doğru aksanı yakalamak
+ * zorunda kalmak — özellikle mobil klavyede — aramayı bitiren bir sürtünme.
+ *
+ * <h3>Türkçe `İ` özel durumu</h3>
+ * `toLowerCase()`ten <em>önce</em> `İ → i` eşlenir: varsayılan küçültme
+ * "İSTANBUL"u "i̇stanbul" (birleşik nokta ile) yapıyor ve eşleşmeyi
+ * kaçırıyordu. Aynı sorun `ı` için ters yönde yok — o zaten tek kod noktası.
+ *
+ * <p>Latin-1 aksanları (`é`, `ñ`, `ü`…) `NFD` ayrıştırması + birleştirici
+ * işaret temizliğiyle sökülür; Türkçe harfler bu yolla çözülmediği için
+ * (`ı` ve `İ` ayrı kod noktaları) önce elle eşlenir.
+ */
+export declare const normalizeSearchTerm: (value: string) => string;
+
+export declare const PageHeader: typeof PageHeader_2;
+
+/**
+ * Sayfa başlığı — her ekranın aynı giriş bloğu.
+ *
+ * <h3>Neden ortak bir bileşen</h3>
+ * Önceden her container kendi başlığını kuruyordu: bir sayfada punto 29 px,
+ * diğerinde 23 px; birinde açıklama başlığın altında, birinde yanında;
+ * boşluklar 8 px ile 24 px arasında dolaşıyordu. Sayfalar arası geçiş "başka
+ * bir siteye geçtim" hissi veriyordu. Bu bileşen o kararları tek yerde verir.
+ *
+ * <h3>Açıklama genişliği sınırlı</h3>
+ * Başlık tam genişlikte akabilir ama açıklama 68ch'de durur: 1360 px
+ * genişlikte akan bir açıklama satırında göz satır sonunda yerini kaybediyor.
+ *
+ * <h3>Eylemler `flex-end`</h3>
+ * Düğmeler başlık bloğunun ALT kenarına hizalanır. `baseline` verildiğinde iki
+ * satırlık başlıklarda düğme ilk satıra çekiliyordu.
+ */
+declare const PageHeader_2: FC<Props_19>;
+
+export declare const Pagination: typeof Pagination_2;
+
+/**
+ * Sayfalama.
+ *
+ * <h3>Sayfa numaraları BAĞLANTI, düğme değil</h3>
+ * `buildHref` verildiğinde numaralar `<a>` olur. Düğme olarak bırakıldığında
+ * iki bedeli vardı:
+ * <ul>
+ *   <li><strong>Tarayıcı (crawler) ikinci sayfaya geçemiyordu.</strong> Düğmenin
+ *       `href`i yok; arama motoru bir tıklama olayını çalıştırmaz. Derin
+ *       sayfalardaki kayıtlar yalnızca sitemap'te göründükleri kadar
+ *       keşfedilebiliyordu.</li>
+ *   <li><strong>Kullanıcı yeni sekmede açamıyordu.</strong> Orta tık, Cmd+tık ve
+ *       "bağlantıyı kopyala" çalışmıyor, durum çubuğunda hedef görünmüyordu.</li>
+ * </ul>
+ *
+ * <p>Oklar her iki kipte de `IconButton`: devre dışı kalabildikleri için düğme
+ * kalırlar — `<a>` etiketinin "devre dışı" hâli yok, `aria-disabled` ise
+ * tıklamayı engellemez. Sayfa numaraları tarayıcıya zaten tam listeyi veriyor.
+ */
+declare const Pagination_2: FC<Props_35>;
+
+export declare const Panel: typeof Panel_2;
+
+/**
+ * Panel — başlığı olan içerik kutusu.
+ *
+ * <h3>Neden bu bileşen var</h3>
+ * Bir uygulamanın on bir ayarlar sayfası, on bir farklı kart kuruyordu:
+ * birinde dolgu 16 px diğerinde 24 px, birinde başlık kartın içinde diğerinde
+ * dışında, birinde `max-width: 560px` diğerinde tam genişlik. Aynı disiplinde
+ * görünmeleri için kararların tek yerde verilmesi gerekiyordu.
+ *
+ * <h3>Genişlik paneli DEĞİL içeriği sınırlar</h3>
+ * Panel her zaman kapsayıcısını doldurur. Form alanlarının okunabilir satır
+ * uzunluğunu aşmaması gerekiyorsa {@link PanelForm} kullanılır — o iç ızgarayı
+ * sınırlar, panelin kendisini daraltmaz. Önceden bir "profil düzenle" paneli
+ * sayfanın üçte biri kadar kalıp yanındaki boşluğa bakıyordu; sorun formun
+ * değil PANELİN daraltılmasıydı.
+ *
+ * @example
+ * <Panel title="Profil bilgileri" description="Fatura bu bilgilerle kesilir">
+ *   <PanelForm>…alanlar…</PanelForm>
+ * </Panel>
+ */
+declare const Panel_2: FC<Props_20>;
+
+/**
+ * Panel içindeki form ızgarası.
+ *
+ * <p>Genişliği SINIRLI (`$measure-narrow`): girdi alanları okunabilir satır
+ * uzunluğunun ötesine uzamamalı — 900 px genişliğinde bir metin kutusu
+ * doldurulması zor görünür. Ama bu sınır PANELE değil ızgaraya uygulanır;
+ * panel tam genişlikte kalır ve sayfa düzeni bozulmaz.
+ */
+export declare const PanelForm: FC<PanelFormProps>;
+
+declare type PanelFormProps = {
+    children: ReactNode;
+    /** Sütun sayısı. `2` dar ekranda kendiliğinden tek sütuna düşer. */
+    columns?: 1 | 2;
+    className?: string;
+};
+
+/**
+ * İki alanı yan yana koyan satır. Dar ekranda alt alta düşer.
+ *
+ * <p>`PanelForm columns={2}` tüm ızgarayı ikiye böler; bu yalnızca TEK bir
+ * satırı böler (ad + soyad gibi).
+ */
+export declare const PanelRow: FC<PanelRowProps>;
+
+declare type PanelRowProps = {
+    children: ReactNode;
+    className?: string;
+};
+
+/**
+ * `showModal()` ÇAĞRILDIKTAN SONRA çağrılır. Odak bir metin alanına düştüyse
+ * panelin kendisine geri alınır; düşmediyse hiçbir şey yapılmaz.
+ */
+export declare const preventAutoKeyboard: (dialog: HTMLDialogElement) => void;
+
+export declare const Price: typeof Price_2;
+
+/**
+ * Tutar gösterimi.
+ *
+ * <h3>Bileşen HESAP YAPMAZ</h3>
+ * Tutar biçimlenmiş gelir. Kuruşu istemcide çevirmek kayan nokta hatası riski
+ * taşır ve biçimlendirme iki yerde ayrışır: aynı ürün listede "1.299,90",
+ * detayda "1299.9" çıkıyordu. İndirim oranı da dışarıdan gelir — burada
+ * `(1 - fiyat/liste)` hesaplamak için biçimlenmiş metni sayıya çevirmek
+ * gerekirdi ve o kırılgan bir iş.
+ *
+ * <h3>Tutar NÖTR kalır</h3>
+ * Güncel tutar `$text`; üstü çizili eski tutar `$text-3`; indirim yüzdesi
+ * küçük bir yeşil rozet. Kırmızı fiyat ucuz durur ve kırmızıyı "olumsuz"
+ * anlamından koparır.
+ */
+declare const Price_2: FC<Props_21>;
+
+export declare const PromptDialog: typeof PromptDialog_2;
+
+/**
+ * Metin isteyen pencere — `window.prompt()` yerine.
+ *
+ * <h3>Neden</h3>
+ * Tarayıcı istemi tek satırlık, biçimlenemiyor, ana iş parçacığını
+ * kilitliyor ve bazı tarayıcılarda sayfayı engelliyor. Bu bileşen aynı işi
+ * `Modal` + `Field` + girdi ile yapar ve pencere kapanma kuralını
+ * (aşağıda) getirir.
+ *
+ * <h3>Pencere yalnızca BAŞARIDA kapanır</h3>
+ * `onSubmit` reddederse pencere açık kalır ve yazılan metin korunur — istek
+ * patlarsa kullanıcının yazdığı gerekçe geri dönüşsüz silinmemeli. Değer
+ * yalnızca pencere <em>yeniden açılırken</em> `defaultValue`dan tazelenir.
+ *
+ * <h3>Enter gönderir</h3>
+ * Girdi bir `<form>` içinde; dip düğmesi `form` özniteliğiyle ona bağlanır
+ * (`Modal` dip şeridi formun dışında çizer). `multiline` kipinde Enter satır
+ * başı yapar, gönderme düğmeden.
+ */
+declare const PromptDialog_2: FC<Props_31>;
+
+declare type Props = {
+    children: ReactNode;
+    /**
+     * Tema ezmeleri. Yalnızca DEĞİŞTİRİLEN token'lar verilir; verilmeyen her
+     * token varsayılanında kalır.
+     *
+     * <p>Nesne referansı her render'da yeniden üretilirse (satır içi nesne
+     * literali) `<style>` etiketi de her render'da yeniden yazılır. Bileşen
+     * bunu içerik karşılaştırmasıyla engeller ama yine de sabit bir referans
+     * (modül düzeyinde tanımlı bir nesne) tercih edilmeli.
+     */
+    theme?: HanuiThemeConfig;
+    /**
+     * Tüketicinin bağlantı bileşeni. Verilmezse ham `<a>` çizilir.
+     *
+     * @example
+     * import NextLink from 'next/link';
+     * <HanuiProvider linkComponent={NextLink}>…</HanuiProvider>
+     */
+    linkComponent?: HanuiLinkComponent;
+};
+
+declare type Props_10 = {
+    value: number;
+    onChange: (value: number) => void;
+    /** Grubun ve girdinin erişilebilir adı ("Adet"). */
+    label: string;
+    decreaseLabel: string;
+    increaseLabel: string;
+    min?: number;
+    max?: number;
+    isDisabled?: boolean;
+    size?: 'sm' | 'md';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_11 = BaseProps_2 & RequiredProps;
+
+declare type Props_12 = {
+    children: ReactNode;
+    tone?: AlertTone;
+    title?: string;
+    /** Sağda gösterilen eylem (bağlantı veya düğme). */
+    action?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_13 = {
+    /** 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.
+     */
+    imageUrl?: string;
+    /**
+     * Baş harfleri büyütürken kullanılacak dil etiketi ("tr", "az").
+     *
+     * <p>Türkçede ZORUNLU: `toUpperCase()` "i" harfini "I" yapıyor ve "İlhan"ın
+     * baş harfi "I" çıkıyor. `toLocaleUpperCase('tr')` doğru "İ" verir.
+     * Verilmezse çalışma ortamının varsayılan dili kullanılır.
+     */
+    locale?: string;
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_14 = {
+    children: ReactNode;
+    tone?: BadgeTone;
+    variant?: BadgeVariant;
+    /** Küçük ikon; metnin solunda gösterilir. */
+    icon?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_15 = {
+    items: Crumb[];
+    /** Gezinme bölgesinin erişilebilir adı ("Konum", "Breadcrumb"). */
+    label: string;
+    /** Yönlendiriciye geçirilecek ek props. */
+    linkProps?: HanuiLinkExtraProps;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_16 = {
+    /** Gösterilecek ve panoya kopyalanacak değer. */
+    value: string;
+    /** Kopyalama düğmesinin erişilebilir adı ve `title`ı. */
+    copyLabel: string;
+    /** Kopyalandıktan sonraki erişilebilir ad ve `title`. */
+    copiedLabel: string;
+    /** `aria-live` ile duyurulan onay cümlesi ("Panoya kopyalandı"). */
+    copiedAnnouncement: string;
+    size?: 'sm' | 'md';
+    /**
+     * Kopyalama düğmesini gizler.
+     *
+     * <p>Yalnızca değerin <em>zaten tıklanabilir bir şeyin içinde</em> olduğu
+     * yerlerde (bir bağlantının gövdesi) verilir: iç içe etkileşim öğesi geçersiz
+     * HTML üretir.
+     */
+    isReadOnly?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_17 = {
+    /** Ortada gösterilen metin ("veya"). */
+    label?: string;
+    className?: string;
+};
+
+declare type Props_18 = {
+    title: string;
+    description?: string;
+    icon?: ReactNode;
+    /** Kullanıcının buradan çıkabileceği eylem. */
+    action?: ReactNode;
+    /** İkincil eylem veya ipucu. */
+    secondaryAction?: ReactNode;
+    size?: 'sm' | 'md';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_19 = {
+    title: string;
+    /** Başlığın üstündeki küçük bağlam etiketi ("HESABIM", "KATEGORİ"). */
+    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. */
+    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.
+     */
+    meta?: ReactNode;
+    /** Başlık bloğunun altında duran ek içerik (filtre şeridi, sekmeler). */
+    children?: ReactNode;
+    /** `h1` sayfada bir kez bulunur; iç bölümler `h2` alır. */
+    as?: 'h1' | 'h2';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_2 = Omit<AnchorHTMLAttributes<HTMLAnchorElement>, 'href'> & {
+    href: string;
+    children: ReactNode;
+    /** Sonda ok gösterilir — "devam et" anlamı taşıyan bağlantılarda. */
+    hasArrow?: boolean;
+    tone?: 'brand' | 'muted';
+    size?: 'sm' | 'md';
+    /** Yönlendiriciye geçirilecek ek props. */
+    linkProps?: HanuiLinkExtraProps;
+};
+
+declare type Props_20 = {
+    children: ReactNode;
+    /** Panel başlığı. Verilmezse başlık şeridi hiç çizilmez. */
+    title?: string;
+    /** Başlık altındaki tek satırlık açıklama. */
+    description?: ReactNode;
+    /** Başlık şeridinin sağında duran eylemler. */
+    actions?: ReactNode;
+    /** Başlık şeridindeki ikon; başlığın solunda. */
+    icon?: ReactNode;
+    /** Gövde dolgusunu kaldırır: tablo ve tam genişlikte listeler için. */
+    isFlush?: boolean;
+    /** Gövde içindeki dikey aralık. */
+    gap?: 'sm' | 'md' | 'lg';
+    /** Dipte duran eylem şeridi (form kaydet, toplam). */
+    footer?: ReactNode;
+    as?: ElementType;
+    className?: string;
+    bodyClassName?: string;
+    testId?: string;
+};
+
+declare type Props_21 = {
+    /** BİÇİMLENMİŞ tutar: "1.299,90". Bileşen hesap yapmaz. */
+    value: string;
+    /** Para birimi simgesi ya da kodu: "₺", "$", "EUR". */
+    currency: string;
+    /** Üstü çizili liste fiyatı; indirim varsa verilir (biçimlenmiş). */
+    listValue?: string;
+    /** İndirim oranı (tam sayı yüzde). */
+    discountPercent?: number;
+    /** İndirim rozetinin metnini üretir ("%20", "-20%"). */
+    formatDiscount?: (percent: number) => string;
+    size?: 'sm' | 'md' | 'lg' | 'xl';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_22 = {
+    /** 0–5 arası puan. Yarım yıldız desteklenir. */
+    value: number;
+    /** Değerlendirme sayısı; verilirse yıldızların yanında gösterilir. */
+    count?: number;
+    /**
+     * Ekran okuyucuya okunan metin — ZORUNLU.
+     *
+     * <p>Yıldızlar `aria-hidden`: beş ayrı ikonu tek tek duyurmak anlamsız.
+     * Yerine bir cümle okunur ("5 üzerinden 4,5 — 12 değerlendirme") ve o cümle
+     * hem dile hem sayı biçimine bağlı; kütüphane onu uyduramaz.
+     */
+    srLabel: string;
+    size?: 'sm' | 'md';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_23 = {
+    title: string;
+    description?: string;
+    /** Üstte gösterilen küçük büyük-harf etiket. */
+    overline?: string;
+    /** Sağda gösterilen eylem ("Tümünü gör"). */
+    action?: ReactNode;
+    as?: 'h1' | 'h2' | 'h3';
+    size?: 'sm' | 'md' | 'lg';
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_24 = {
+    /** Genişlik: sayı px, dize doğrudan CSS değeri. */
+    width?: number | string;
+    height?: number | string;
+    /** Metin satırı görünümü: yuvarlatılmış, satır yüksekliğinde. */
+    variant?: 'block' | 'text' | 'circle';
+    /** Kaç satır çizilecek (`text` için). */
+    lines?: number;
+    className?: string;
+};
+
+declare type Props_25 = {
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * Ekran okuyucuya okunacak metin; görsel olarak gizli.
+     *
+     * <p>ZORUNLU ve boş dizeye izin verilir. Bekleme durumunun duyurulması
+     * gerekiyor ("Yükleniyor"), ama göstergenin <em>zaten adı olan</em> bir
+     * öğenin içinde durduğu yerlerde (yükleniyor durumundaki bir düğme)
+     * duyurmak tekrar üretiyor. O zaman `label=""` geçilir; karar çağıranın
+     * ve bilinçli olmak zorunda.
+     */
+    label: string;
+    className?: string;
+};
+
+declare type Props_26 = {
+    items: TabItem[];
+    /** Kontrolsüz kullanımda açılışta seçili sekme. */
+    defaultTabId?: string;
+    /**
+     * Kontrollü kullanım: seçili sekme çağıranın durumunda.
+     *
+     * <p>`onChange` ile birlikte verilir. Kontrolsüz sürüm (yalnızca
+     * `defaultTabId`) korunur — kendi durumunu tutması yeterli olan sekmelerin
+     * dışarıdan yönetilmesi gereksiz.
+     */
+    activeId?: string;
+    onChange?: (id: string) => void;
+    /** Sekme çubuğunun erişilebilir adı. */
+    ariaLabel?: string;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_27 = {
+    label: string;
+    /** İkon DIŞARIDAN gelir: hangi ikonun hangi konuya ait olduğu uygulamanın bilgisi. */
+    icon: ReactNode;
+    href: string;
+    /** Etiketin altında gösterilen ikincil satır ("1.248 kayıt"). */
+    meta?: ReactNode;
+    isActive?: boolean;
+    /** Yönlendiriciye geçirilecek ek props. */
+    linkProps?: HanuiLinkExtraProps;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_28 = {
+    title: string;
+    /** 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.
+     */
+    toolbar?: ReactNode;
+    /** Dipte duran eylem şeridi. */
+    footer?: ReactNode;
+    /**
+     * Panelin <strong>kendiliğinden kapandığı</strong> medya sorgusu.
+     *
+     * <p>Varsayılan mobil eşiği (`>640`), çünkü seçim kutuları o eşiğin üstünde
+     * listeyi yapışkan panelde açıyor. Kendi eşiği daha geniş olan çağıranlar
+     * kendi sorgusunu verir; aksi hâlde 800 px'te açılan panel pencere 641 px'i
+     * geçtiğinde kapanıyor ya da hiç kapanmıyordu.
+     */
+    closeAbove?: string;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_29 = {
+    isOpen: boolean;
+    onClose: () => void;
+    title: string;
+    /** Kapatma düğmesinin erişilebilir adı ("Kapat", "Close"). */
+    closeLabel: string;
+    children?: ReactNode;
+    /**
+     * Başlığın altındaki bir cümlelik açıklama.
+     *
+     * <p>`aria-describedby` ile pencereye bağlanır: ekran okuyucu pencere
+     * açıldığında başlıkla birlikte bunu da okur. Gövdeye paragraf olarak
+     * yazıldığında duyurulmuyordu.
+     */
+    description?: ReactNode;
+    /** Altta duran eylemler. Sağa yaslanır; dar ekranda tam genişliğe yayılır. */
+    footer?: ReactNode;
+    /** Başlığın solunda duran ikon madalyonu; `tone` rengini alır. */
+    icon?: ReactNode;
+    /** İkon madalyonunun tonu. */
+    tone?: ModalTone;
+    size?: 'sm' | 'md' | 'lg';
+    /**
+     * `false` iken arka plana tıklama, Escape ve kapatma düğmesi kapatmaz.
+     *
+     * <p>Yalnızca <strong>sürmekte olan</strong> bir işlem için: silme isteği
+     * gönderilmişken pencerenin kapanması, kullanıcıya işlem iptal edilmiş gibi
+     * görünüyordu.
+     */
+    isDismissable?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_3 = {
+    /** Balonda gösterilecek açıklama. */
+    content: ReactNode;
+    /** Açıklamanın bağlandığı öğe — düğme, ikon, etiket. */
+    children: ReactNode;
+    /** Varsayılan üstte; alanı olmayan yerlerde `bottom`. */
+    position?: 'top' | 'bottom';
+    className?: string;
+};
+
+declare type Props_30 = {
+    isOpen: boolean;
+    onClose: () => void;
+    /**
+     * Onaylandığında çalışır. `Promise` dönerse düğme beklerken yükleme
+     * durumuna geçer ve pencere <strong>kapanmaz</strong>.
+     *
+     * <p>İşlem başarılıysa pencereyi kapatmak çağıranın işi: hata durumunda
+     * pencerenin açık kalması gerekiyor ki kullanıcı tekrar deneyebilsin.
+     */
+    onConfirm: () => void | Promise<void>;
+    /** Soru cümlesi. Eylem odaklı yazılır: "…silinsin mi?". */
+    title: string;
+    /** Sonucu açıklar: neyin geri alınamaz olduğu burada yazılır. */
+    description?: ReactNode;
+    /** Onay düğmesinin etiketi. Eylemi TEKRARLAR: "Sil", "İptal et". */
+    confirmLabel: string;
+    cancelLabel: string;
+    /** Kapatma düğmesinin erişilebilir adı. */
+    closeLabel: string;
+    kind?: ConfirmKind;
+    /** Ek bağlam: silinecek kaydın özeti, uyarı kutusu. */
+    children?: ReactNode;
+};
+
+declare type Props_31 = BaseProps_3 & RequiredProps_2;
+
+declare type Props_32 = 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.
+     */
+    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.
+     */
+    hasStickyHead: boolean;
+    /** Satır hover zemini: çok sütunlu tabloda göz satırını kaybediyor. */
+    hasRowHover: boolean;
+}>;
+
+declare type Props_33 = {
+    columns: DataTableColumn[];
+    /**
+     * 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}.
+     */
+    children?: ReactNode;
+    /** Satır yokken gösterilen metin. */
+    emptyMessage: string;
+    /** Yükleme sürerken satırların yerine 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.
+     */
+    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.
+     */
+    hasViewportCap?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_34 = {
+    /**
+     * 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. */
+    children: ReactNode;
+    /** Şeridin sağ ucundaki eylemler ("Uygula" düğmesi gibi). */
+    actions?: ReactNode;
+    /** Şeridin erişilebilir adı ("Filtreler"). */
+    label: string;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_35 = LinkProps | ButtonProps;
+
+declare type Props_4<T extends string> = SingleProps<T> | MultipleProps<T>;
+
+declare type Props_5<T extends string> = {
+    options: ComboboxOption<T>[];
+    value: T | null;
+    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.
+     */
+    onSearch?: (query: string) => void;
+    isLoading?: boolean;
+    isDisabled?: boolean;
+    /** Seçimi kaldıran çarpı düğmesi gösterilir. */
+    isClearable?: boolean;
+    /**
+     * Arama kutusu GİZLENİR.
+     *
+     * <p>Az sayıda, sabit seçenekli listelerde arama bir işe yaramıyor: altı
+     * satırı taramak yazmaktan hızlı ve kutu açılışta odağı çalıp mobilde
+     * klavyeyi açıyordu. Ok tuşlarıyla gezinme ve `Escape` yine çalışır.
+     */
+    isSearchHidden?: boolean;
+    /** Tetikleyicinin solundaki ikon. */
+    icon?: ReactNode;
+    id?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_6<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.
+     *
+     * <p>Tetikleyici bir `<button>` ve düğmenin adı HTML-AAM'e göre
+     * `<label>`den GELMEZ — görünür bir etiket olsa bile ekran okuyucu yalnızca
+     * seçili değeri okur ("En yeni, düğme") ve neyi seçtiğini söylemez.
+     */
+    label: string;
+    /** Seçim yokken tetikleyicide görünen metin. */
+    placeholder: string;
+    /** Alt sayfanın kapatma düğmesinin erişilebilir adı. */
+    closeLabel: string;
+    /** Tetikleyicinin solundaki ikon. */
+    icon?: ReactNode;
+    /** `sm` yoğun şeritler içindir (araç çubuğu); varsayılan form ölçüsü `md`. */
+    size?: 'sm' | 'md';
+    /**
+     * Panelin hangi kenardan hizalanacağı.
+     *
+     * <p>Şeridin sağ ucundaki bir tetikleyicide `start` hizalama paneli sağa
+     * doğru taşırıyordu; `end` panelin sağ kenarını tetikleyiciye yaslar.
+     */
+    align?: 'start' | 'end';
+    isDisabled?: boolean;
+    id?: string;
+    'aria-describedby'?: string;
+    'aria-invalid'?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_7 = {
+    /** Radyo grubu adı — aynı gruptaki kartlar ok tuşlarıyla gezilir. */
+    name: string;
+    value: string;
+    isSelected: boolean;
+    isDisabled?: boolean;
+    onChange: (value: string) => void;
+    /** Zengin gövde: kartın içeriği çağırana aittir. */
+    children: ReactNode;
+} & CommonElementProps;
+
+declare type Props_8 = {
+    min: number;
+    max: number;
+    step?: number;
+    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.
+     */
+    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 ("En az"). */
+    minLabel: string;
+    /** Üst kulbun erişilebilir ad eki ("En çok"). */
+    maxLabel: string;
+    isDisabled?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+declare type Props_9 = {
+    value: number | null;
+    onChange: (value: number) => void;
+    /** Grubun erişilebilir adı ("Ürün puanı"). */
+    label: string;
+    /**
+     * Puan açıklamaları — ZORUNLU. Hem ekran okuyucuya okunur hem de seçildiğinde
+     * yıldızların altında yazar.
+     *
+     * <p>Dolu yıldız sayısı tek başına bir renk/şekil sinyali. Yanına açıklama
+     * yazmak hem anlamı netleştirir hem de renk körü kullanıcıya ikinci bir ipucu
+     * verir (WCAG 1.4.1).
+     */
+    ratingLabels: RatingLabels;
+    /** Ekran okuyucuda yıldız sayısını okuyan biçimlendirici ("4 yıldız"). */
+    formatStarCount: (star: number) => string;
+    isDisabled?: boolean;
+    className?: string;
+    testId?: string;
+};
+
+export declare const QuantityStepper: typeof QuantityStepper_2;
+
+/**
+ * Adet seçici.
+ *
+ * <p>Doğrudan yazma da desteklenir: 12 adet isteyen kullanıcının artı düğmesine
+ * on iki kez basması kabul edilemez.
+ *
+ * <p>Yazılan değer <strong>odak kaybında</strong> sınırlara çekilir, her tuş
+ * vuruşunda değil: "12" yazarken "1"i anında 1'e sabitlemek kullanıcının
+ * yazmasını engellerdi.
+ */
+declare const QuantityStepper_2: FC<Props_10>;
+
+export declare const Radio: typeof Radio_2;
+
+/**
+ * Radyo düğmesi.
+ *
+ * <p>{@link Checkbox} ile aynı gerekçe: yerel `<input type="radio">` korunur
+ * ve `accent-color` ile renklendirilir. Sahte bir daire çizmek ok tuşlarıyla
+ * gezinmeyi ve grup duyurusunu elle yeniden kurmayı gerektirirdi.
+ *
+ * <p>Tüm satır tıklanabilir (`<label>` sarmalar): 18 px'lik daireyi
+ * hedeflemek özellikle dokunmatik ekranda yorucu.
+ */
+declare const Radio_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
+label: ReactNode;
+hint?: string;
+/** Sağda gösterilen sonuç adedi (filtre listelerinde). */
+count?: number;
+testId?: string;
+} & RefAttributes<HTMLInputElement>>;
+
+export declare const RadioCard: typeof RadioCard_2;
+
+/**
+ * Seçilebilir kart — zengin gövdeli radyo.
+ *
+ * <h3>Neden ayrı bir öğe</h3>
+ * Varyant seçici ve hesap seçici aynı deseni elle kuruyordu: `<label>` + gizli
+ * radyo + gövde + seçili/pasif durum matrisi. İki kopya çoktan ayrışmıştı —
+ * biri odak halkasını metnin üstüne, diğeri hiç çizmiyordu; biri seçili zemini
+ * boyuyor, diğeri boyamıyordu.
+ *
+ * <h3>Radyo GERÇEK, daire çizim</h3>
+ * `<input type="radio">` görsel olarak gizlenir ama DOM'da kalır: ok
+ * tuşlarıyla grup içinde gezinme, `Space` ile seçim ve ekran okuyucu duyurusu
+ * tarayıcıdan gelir. Yerel daire bu boyutta bir kartta görsel olarak
+ * kaybolduğu için işaret ayrıca çizilir (`__indicator`).
+ *
+ * <h3>Seçim üç sinyalle</h3>
+ * Kenarlık + zemin tinti + dolan işaret aynı anda değişir. İşaretin dolu / boş
+ * hâli bir BİÇİM farkıdır — renk tek başına anlam taşımaz (WCAG 1.4.1).
+ *
+ * <p>Odak halkası kartın kendisinde (`:has(:focus-visible)`): gizli girdiye
+ * çizilen halka görünmüyor, yalnızca metne çizilen halka da kartın nerede
+ * bittiğini söylemiyordu.
+ *
+ * <p>{@link Radio} yalın satır içindir, gövde taşıyamaz — ikisi karışmaz.
+ */
+declare const RadioCard_2: FC<Props_7>;
+
+export declare const RangeSlider: typeof RangeSlider_2;
+
+/**
+ * Çift kulplu aralık kaydırıcı.
+ *
+ * <h3>Neden iki gerçek `<input type="range">`</h3>
+ * Kulplar `<div>` ile çizilip sürükleme JavaScript'le yazıldığında klavye
+ * desteği, ekran okuyucu duyurusu ve dokunma davranışı elle yeniden kurulmak
+ * zorunda kalır — ve pratikte biri hep eksik kalır. Üst üste bindirilmiş iki
+ * yerel aralık girdisi bunların hepsini ücretsiz getirir: ok tuşları, Home/End,
+ * PageUp/PageDown ve aralık duyurusu kendiliğinden çalışır.
+ *
+ * <h3>Kulplar birbirini geçemez</h3>
+ * Alt kulp üst değeri, üst kulp alt değeri aşamaz. Geçmelerine izin vermek
+ * "en az 8.000, en çok 1.200" gibi anlamsız bir aralık üretiyordu.
+ *
+ * <h3>Sayı değil METİN duyurulur</h3>
+ * `aria-valuetext` biçimlenmiş değeri taşır. Aksi hâlde ekran okuyucu ham
+ * sayıyı ("bir milyon iki yüz elli bin") okuyordu.
+ *
+ * <h3>`onChange` ile `onCommit` ayrıdır</h3>
+ * Kaydırırken her adımda adres çubuğuna yazmak, tek bir sürüklemede onlarca
+ * gezinme kaydı bırakıp geri tuşunu kullanılamaz hâle getiriyordu. Ekran anında
+ * güncellenir (`onChange`), sorgu yalnızca kulp bırakılınca yazılır.
+ */
+declare const RangeSlider_2: ({ min, max, step, value, onChange, onCommit, formatValue, label, minLabel, maxLabel, isDisabled, className, testId, }: Props_8) => JSX.Element;
+
+export declare type RangeValue = [number, number];
+
+export declare const Rating: typeof Rating_2;
+
+/**
+ * Yıldız puanı — salt gösterim.
+ *
+ * <p>Ortalama sunucuda hesaplanır; burada yalnızca gösterilir. Puanı
+ * istemcide hesaplamak, sayfalama yüzünden eksik veriyle yanlış ortalama
+ * üretirdi.
+ *
+ * <p>Etkileşimli kardeşi {@link RatingInput}.
+ */
+declare const Rating_2: FC<Props_22>;
+
+export declare const RatingInput: typeof RatingInput_2;
+
+/**
+ * Yıldızla puan girişi.
+ *
+ * <h3>Beş gerçek radyo düğmesi</h3>
+ * Yıldızlar `<span>` ile çizilip tıklama JavaScript'e bağlanabilirdi. Bunun
+ * yerine `<fieldset>` içinde beş yerel `<input type="radio">` kullanılır ve
+ * yıldız görünümü etiketlerine verilir. Böylece ok tuşlarıyla gezinme, Tab
+ * davranışı, ekran okuyucuda "5 seçenekten 4'ü seçili" duyurusu ve form
+ * gönderimine katılma <em>bedava</em> gelir.
+ *
+ * <p>{@link Rating} genişletilemez: o `<span>` üretiyor ve açıkça
+ * salt-gösterim. İkisini tek bileşende toplamak, gösterim tarafına hiç
+ * kullanılmayan etkileşim kodu taşımak olurdu.
+ */
+declare const RatingInput_2: ({ value, onChange, label, ratingLabels, formatStarCount, isDisabled, className, testId, }: Props_9) => JSX.Element;
+
+/** Beş puanın her birinin ne anlama geldiği. */
+export declare type RatingLabels = Record<1 | 2 | 3 | 4 | 5, string>;
+
+/**
+ * Zorunluluk işareti ve onun ekran okuyucu karşılığı BİRLİKTE verilir.
+ *
+ * <p>Yıldız yalnızca görsel bir kısayol; renk ve şekil tek başına anlam
+ * taşıyamaz (WCAG 1.4.1). `requiredLabel` bir dil kararı ve kütüphane onu
+ * uyduramaz — bu yüzden `isRequired` verildiğinde tip zorunlu kılıyor.
+ */
+declare type RequiredProps = {
+    isRequired: true;
+    requiredLabel: string;
+} | {
+    isRequired?: false;
+    requiredLabel?: never;
+};
+
+/** Zorunluluk işareti ve ekran okuyucu karşılığı birlikte (bkz. {@link Field}). */
+declare type RequiredProps_2 = {
+    isRequired: true;
+    requiredLabel: string;
+} | {
+    isRequired?: false;
+    requiredLabel?: never;
+};
+
+/** Verilen şemanın tam token eşlemesi — ezmeler uygulanmış hâliyle. */
+export declare const resolveTokens: (scheme: HanuiColorScheme, config?: HanuiThemeConfig) => HanuiResolvedTokens;
+
+declare type RowProps = HTMLAttributes<HTMLTableRowElement> & {
+    children: ReactNode;
+    /**
+     * Satır dikkat bekleyen iş taşıyor (kritik stok, karar bekleyen talep).
+     *
+     * <p>TEK desen: tint zemin + ilk hücrede sol kenar işareti. Önceden iki
+     * uygulama vardı — yalnız düz uyarı zemini ve zemin + sol iç gölge. Zemin
+     * tek başına yetmiyordu: hover vurgusu tinti ezince satırın "iş bekliyor"
+     * bilgisi kayboluyordu ve renk tek başına zaten anlam taşıyamaz (WCAG
+     * 1.4.1) — sol işaret hover'da da yerinde kalır.
+     */
+    isWarning?: boolean;
+};
+
+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.
+     */
+    hasFrame?: boolean;
+};
+
+export declare const SectionHeader: typeof SectionHeader_2;
+
+/**
+ * Bölüm başlığı.
+ *
+ * <p>Başlık düzeyi (`as`) görsel boyuttan (`size`) <strong>ayrı</strong>:
+ * sayfa hiyerarşisi anlamsal olmak zorunda ama görsel boyut bağlamla değişir.
+ * İkisini birbirine bağlamak, doğru görünüm için yanlış başlık düzeyi seçmeye
+ * zorlardı.
+ */
+declare const SectionHeader_2: FC<Props_23>;
+
+export declare const Select: typeof Select_2;
+
+/**
+ * Seçim kutusu.
+ *
+ * <h3>Yerel `<select>` KULLANILMAZ</h3>
+ * Yerel açılır liste her tarayıcıda başka türlü çiziliyor, seçeneklerine tek
+ * bir stil verilemiyor (seçili değeri işaretlemek, ikon koymak, satırı
+ * yükseltmek yok) ve mobilde ekranın ortasında beliren tekerlek uygulamanın
+ * geri kalanına hiç benzemiyordu. Kutu baştan sona bizim: masaüstünde
+ * tetikleyicinin altında bir panel, mobilde ekranın dibinden yükselen bir
+ * <strong>alt sayfa</strong> açar.
+ *
+ * <p>Bu, "yerel öğe taklit öğeden iyidir" kuralının BİLİNÇLİ tek istisnası:
+ * bedeli (odak yönetimi, ok tuşları, `aria-activedescendant`) bir kez ödenip
+ * tek bileşene kapatıldı.
+ *
+ * <h3>Klavye — odak TEK yerde</h3>
+ * Panel açıkken odak tetikleyicide kalır, alt sayfada ise listenin kendisine
+ * geçer; iki durumda da etkin seçenek `aria-activedescendant` ile bildirilir.
+ * Seçenekleri tek tek odaklanabilir yapmak, aynı bileşende iki ayrı klavye
+ * modeli demekti (APG: listbox + activedescendant).
+ *
+ * <h3>20+ seçenek varsa bu bileşen DEĞİL</h3>
+ * Aramasız bir liste 20 satırdan sonra taranamaz hâle gelir; orada
+ * {@link Combobox} kullanılır.
+ */
+declare const Select_2: <T extends string>({ options, value, onChange, label, placeholder, closeLabel, icon, size, align, isDisabled, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_6<T>) => JSX.Element;
+
+export declare type SelectOption<T extends string = string> = {
+    value: T;
+    label: string;
+    isDisabled?: boolean;
+};
+
+declare type SingleProps<T extends string> = BaseProps<T> & {
+    isMultiple?: false;
+    value: T | null;
+    /** Seçili çipe tekrar basılırsa `null` gelir — seçim geri alınabilir. */
+    onChange: (value: T | null) => void;
+};
+
+export declare const Skeleton: typeof Skeleton_2;
+
+/**
+ * Yükleme iskeleti.
+ *
+ * <h3>Neden dönen çark yerine iskelet</h3>
+ * İskelet gelecek içeriğin <em>şeklini</em> gösterir; kullanıcı ne beklediğini
+ * bilir ve içerik geldiğinde yerleşim kaymaz (CLS). Dönen bir çark hem konumu
+ * hem boyutu belirsiz bırakır.
+ *
+ * <p>`aria-hidden`: ekran okuyucuya "yükleniyor" bilgisini veren, iskeletin
+ * kendisi değil onu saran bölgenin `aria-busy` özelliğidir.
+ */
+declare const Skeleton_2: FC<Props_24>;
+
+export declare const Spinner: typeof Spinner_2;
+
+/**
+ * Yükleme göstergesi.
+ *
+ * <p>İskelet (`Skeleton`) tercih edilir; bu bileşen yalnızca <em>şekli
+ * bilinmeyen</em> bir bekleme için — düğme içi işlem veya belirsiz süreli bir
+ * sorgu gibi.
+ */
+declare const Spinner_2: FC<Props_25>;
+
+export declare type TabItem = {
+    id: string;
+    label: string;
+    /** Etiketin yanında gösterilen sayı. */
+    count?: number;
+    /**
+     * Sekmenin paneli.
+     *
+     * <p>Verilmezse bileşen yalnızca <strong>sekme çubuğu</strong> çizer ve
+     * içeriği çağıran taraf yönetir. Bir formun üç kipi tek bir panelin içinde
+     * yaşıyorsa üç ayrı panel yazmak aynı alanları üç kez tanımlamak olurdu.
+     */
+    content?: ReactNode;
+};
+
+export declare const Table: typeof Table_2;
+
+/**
+ * Temel tablo — hairline satır ayrımı, `$surface-2` başlık, yoğunluk ölçeği.
+ *
+ * <p>Görsel kararlar (hangi hücre monospace, hangi sütun sabit) çağıranın
+ * modülünde kalır; teknik değer hücresi `@include technical-text` ile
+ * yazılır. Bileşen yalnızca üç tabloda üçe ayrışmış iskelet kurallarını tek
+ * yerde toplar.
+ *
+ * <p>Operasyon ekranlarının durum satırlı (yükleniyor/hata/boş) sürümü için
+ * {@link DataTable}.
+ */
+declare const Table_2: FC<Props_32>;
+
+export declare const TableCheckbox: typeof TableCheckbox_2;
+
+/**
+ * Tablo hücresindeki toplu seçim kutusu.
+ *
+ * <h3>Neden `Checkbox` değil</h3>
+ * Seçim sütununda etiket sütun başlığıdır ve `Checkbox` bileşeninin ürettiği
+ * `<label>` sarmalayıcısı (yan yana kutu + metin yerleşimi) hücreyi bozar.
+ * Doğru olan yalın `<input type="checkbox">` + `aria-label` — bu bileşen o
+ * deseni resmileştirir ki ekranlar çıplak `<input>` yazmak zorunda kalmasın.
+ *
+ * <p>Renk `Checkbox` ile aynı kaynaktan: `accent-color` mavi — onay kutusu bir
+ * seçimdir, bir dönüşüm değil.
+ */
+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ç").
+*/
+label: string;
+testId?: string;
+} & RefAttributes<HTMLInputElement>>;
+
+/**
+ * Tablo kaydırma kutusu — "tablo kendi kutusunda kayar, sayfa asla yatay
+ * kaymaz" kuralının tek uygulaması.
+ *
+ * <p>Yatay kaydırma yalnızca BİLEREK kurulur: geniş tablo bu kutunun içinde
+ * kayar; `min-width: 0` + `align-self: stretch` kutunun esnek bir kapsayıcıda
+ * kendisinin taşmasını engeller. Üç tablonun üç ayrı elle kurulmuş (ya da hiç
+ * kurulmamış) kaydırma stratejisi vardı; stratejisi olmayan tabloda monospace
+ * değerler 360 px'te sayfanın kendisini yatay kaydırıyordu.
+ *
+ * <p>Kaydırma çubuğu TEMALI (`custom-scrollbar`): işletim sisteminin açık
+ * çubuğu koyu temada tablonun altında parlak bir şerit bırakıyordu.
+ */
+export declare const TableScroller: FC<ScrollerProps>;
+
+export declare const TABLET_BREAKPOINT = 1024;
+
+export declare const TABLET_PORTRAIT_BREAKPOINT = 768;
+
+export declare const Tabs: typeof Tabs_2;
+
+/**
+ * Sekmeler.
+ *
+ * <p>ARIA sekme kalıbı tam uygulanır: `role="tablist"`, `aria-selected`,
+ * `aria-controls` ve ok tuşlarıyla gezinme. Yalnızca görsel olarak sekme gibi
+ * duran düğmeler, klavye kullanıcısı için gezinilemez bir yapı olurdu.
+ *
+ * <p>Seçili olmayan panel DOM'dan çıkarılır: gizli panellerdeki bağlantılar ve
+ * girdiler sekme sırasına girmemeli.
+ *
+ * <h3>İki kullanım</h3>
+ * <ul>
+ *   <li><b>Kontrolsüz + panelli</b> — `items[].content` verilir, bileşen
+ *       seçimi kendisi tutar.</li>
+ *   <li><b>Kontrollü + panelsiz</b> — `activeId` + `onChange` verilir,
+ *       `content` verilmez; bileşen yalnızca çubuğu çizer.</li>
+ * </ul>
+ */
+declare const Tabs_2: FC<Props_26>;
+
+export declare const Textarea: typeof Textarea_2;
+
+/**
+ * Çok satırlı metin girdisi.
+ *
+ * <p>Görünüm {@link Input} ile aynı gövdeden gelir: bir formda tek satırlı ve
+ * çok satırlı alanlar yan yana durur, kenarlık ve odak davranışları ayrışırsa
+ * form derlenmemiş görünür.
+ *
+ * <p>Yeniden boyutlandırma yalnızca <strong>dikey</strong>: yatayda büyütmek
+ * alanı kapsayıcısının dışına taşırıp yerleşimi bozuyordu.
+ */
+declare const Textarea_2: ForwardRefExoticComponent<TextareaHTMLAttributes<HTMLTextAreaElement> & {
+testId?: string;
+} & RefAttributes<HTMLTextAreaElement>>;
+
+export declare const TextLink: typeof TextLink_2;
+
+/**
+ * Metin bağlantısı.
+ *
+ * <h3>Ok bir süs değil</h3>
+ * Sondaki ok yalnızca <em>gezinme</em> bağlantılarında kullanılır ("Tümünü gör
+ * →"). Bir eylemi tetikleyen bağlantıya ok koymak, kullanıcıya başka bir
+ * sayfaya gideceğini söyler ve beklentiyi yanıltır.
+ *
+ * <p>Ok, üzerine gelindiğinde <strong>ilerler</strong>: hareket, bağlantının
+ * götürdüğü yönü fiziksel olarak sezdirir.
+ *
+ * <h3>Alt çizgi hover'da eklenir, kaldırılmaz</h3>
+ * Sürekli altı çizili bağlantılar yoğun bir liste sayfasında görsel gürültü
+ * yaratıyordu. Ama alt çizginin <em>hiç</em> olmaması bağlantıyı düz metinden
+ * ayırt edilemez kılar; renk tek başına yeterli değil (WCAG 1.4.1). Çözüm:
+ * renk her zaman, alt çizgi etkileşimde.
+ */
+declare const TextLink_2: ({ href, children, hasArrow, tone, size, className, linkProps, ...rest }: Props_2) => JSX.Element;
+
+declare type ThemeState = {
+    scheme: HanuiColorScheme;
+    setScheme: (scheme: HanuiColorScheme) => void;
+    toggle: () => void;
+    /**
+     * Sunucu çıktısında ve hidrasyondan önceki ilk karede `false`.
+     *
+     * <p>Tema anahtarı bunu bekler: sunucu hangi temanın seçili olduğunu
+     * bilmiyor ve bir tahminle çizilen anahtar, doğru tahmin edilse bile
+     * hidrasyonda uyuşmazlık üretiyordu. Anahtar hazır olana kadar
+     * `aria-hidden` bir yer tutucu çizilir.
+     */
+    isReady: boolean;
+};
+
+export declare const Tile: typeof Tile_2;
+
+/**
+ * Karo — ikon madalyonu + etiket.
+ *
+ * <h3>Neden ikon, neden yuvarlak madalyon</h3>
+ * Ana giriş noktaları metin listesi olarak verildiğinde kullanıcı satır satır
+ * okuyor. İkon, aranan öğeyi <em>okumadan</em> bulmayı sağlar; madalyon ise
+ * ikona sabit bir kutu verir — farklı ikonların doğal genişlikleri karoları
+ * düzensiz hizalıyordu.
+ *
+ * <h3>Karonun tamamı tıklanabilir</h3>
+ * Bağlantı yalnızca etiketi değil karonun tümünü kaplar. Küçük bir metin
+ * bağlantısını hedeflemek, özellikle dokunmatik ekranda gereksiz bir hassasiyet
+ * talebiydi.
+ *
+ * <h3>`meta` neden sayı değil `ReactNode`</h3>
+ * "1.248 ürün" cümlesi hem sayı biçimine hem dile bağlı. Bileşen içinde
+ * `toLocaleString` çağırmak, o kararı kütüphanenin varsayımına bağlıyordu.
+ */
+declare const Tile_2: ({ label, icon, href, meta, isActive, linkProps, className, testId }: Props_27) => JSX.Element;
+
+export declare const Tooltip: typeof Tooltip_2;
+
+/**
+ * İpucu balonu.
+ *
+ * <h3>Neden native `title` yetmiyor</h3>
+ * Tarayıcının `title` özniteliği <strong>dokunmatikte hiç görünmez</strong>,
+ * gecikmesi ayarlanamaz ve biçimlendirilemez. Trafiğin ağırlığı mobil olan
+ * bir arayüzde "üzerine gelince açıklama çıkar" demek, kullanıcıların çoğu
+ * için açıklamanın hiç olmaması demek.
+ *
+ * <h3>Neden yalnızca AÇIKLAMA taşır</h3>
+ * Balonda <em>yalnızca</em> yardımcı metin durur — bağlantı, düğme veya
+ * okunması zorunlu bir bilgi değil. İpucu klavyeyle odaklanınca ve fareyle
+ * üzerine gelince açılıyor; içine bir eylem konsaydı ona erişmenin yolu
+ * olmazdı (fare balona giderken tetikleyiciden çıkıyor). Kalıcı olması
+ * gereken metin için `Field`ın `hint`i kullanılır.
+ *
+ * <h3>Erişilebilirlik</h3>
+ * Tetikleyici `aria-describedby` ile balona bağlanır — ekran okuyucu öğenin
+ * adını okuduktan sonra açıklamayı da okur. Balon `role="tooltip"`. `Escape`
+ * kapatır: klavye kullanıcısı ipucunu kapatabilmeli.
+ */
+declare const Tooltip_2: FC<Props_3>;
+
+/**
+ * Ölçü basamakları.
+ *
+ * <p>`MEDIUM` ve `LARGE` dokunma hedefi kuralına uyar (WCAG 2.5.8, ≥44 px).
+ * `SMALL` yoğun şeritler içindir ve orada görsel kutu küçülür ama tıklanabilir
+ * alan `tap-target` ile korunur.
+ */
+export declare enum UISize {
+    SMALL = "SMALL",
+    MEDIUM = "MEDIUM",
+    LARGE = "LARGE"
+}
+
+/**
+ * Düğme ve eylem varyantları.
+ *
+ * <p>Sıra bir <strong>vurgu hiyerarşisi</strong>dir: bir ekranda tek bir
+ * `PRIMARY` bulunur. İki dolu düğme yan yana durduğunda hiçbiri öne çıkmaz ve
+ * kullanıcı hangisinin beklenen eylem olduğunu bilemez.
+ *
+ * <h3>Doygun dolgu = tıklanabilir</h3>
+ * Bu kuralın karşılığı: durum etiketleri (rozet, uyarı) her zaman tint
+ * zeminlidir, eylemler her zaman dolgulu veya çerçevelidir. İkisi karışırsa
+ * kullanıcı bir durum etiketine tıklamayı dener.
+ */
+export declare enum UIVariant {
+    /**
+     * Ekranın tek beklenen eylemi: <strong>nötr grafit</strong> dolgu.
+     *
+     * <p>`CART` DEĞİL. Doygun turuncu tek bir dönüşüm noktasına ayrıldı; her
+     * dolu düğmeyi o renge boyamak tekilliği yok eder ve kullanıcı hangi
+     * turuncunun dönüşüm olduğunu bilemez.
+     */
+    PRIMARY = "PRIMARY",
+    /**
+     * <strong>Dönüşüm eylemi — ve yalnızca o.</strong>
+     *
+     * <p>Ekranda görünen tek doygun turuncu. Favori, karşılaştır, paylaş,
+     * filtrele hepsi nötr veya mavidir. Bir kampanya bandında bu ton
+     * kullanılırsa o ekranda dönüşüm düğmesi `PRIMARY`'ye çevrilir — ikisi aynı
+     * anda olmaz.
+     *
+     * <p>Adı domain'den geliyor (kaynak sistemde "sepete ekle") ve
+     * kasıtlı korundu: bir ekranda kaç tane olabileceğini adın kendisi
+     * söylüyor. `ACCENT` deseydi hiyerarşi bilgisi kaybolurdu.
+     */
+    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").
+     *
+     * <p>Çerçeveli, dolgulu değil: mavi gezinme ve keşif rengidir; dolu mavi
+     * düğme onu bir dönüşüm noktası gibi gösterip `CART` ile yarışıyordu.
+     */
+    OUTLINE = "OUTLINE",
+    /** Vurgu bandı içindeki eylem: bandın kendi yüzey merdivenini kullanır. */
+    DARK = "DARK",
+    /** Nötr yüzey dolgusu; kart içi ikincil eylem. */
+    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. */
+    DANGER = "DANGER"
+}
+
+/**
+ * Sağlayıcı ZORUNLU DEĞİL.
+ *
+ * <p>Sağlayıcısız kullanımda bağlantılar ham `<a>` olur ve tema
+ * varsayılanlarda kalır — yani paket `import` edilip hiçbir kurulum
+ * yapılmadan çalışır. Sağlayıcıyı zorunlu kılmak, tek bir `Badge` kullanmak
+ * isteyen bir tüketiciyi de kök yerleşimi değiştirmeye zorluyordu.
+ */
+export declare const useHanui: () => HanuiContextValue;
+
+/**
+ * Açık/koyu seçimini okur ve değiştirir.
+ *
+ * <h3>KALICILIK BU KANCANIN İŞİ DEĞİL</h3>
+ * Seçimi nereye yazacağı tüketicinin kararı: `localStorage`, bir çerez (SSR'da
+ * okunabilmesi için), kullanıcı profili. Kütüphane `localStorage`a yazsaydı
+ * sunucu tarafı onu okuyamayacağı için ilk boyama yine yanlış temada
+ * olurdu — ve tüketici kendi çerezini kullanmak istediğinde iki kaynak
+ * çatışırdı.
+ *
+ * <h3>Geçiş tek karede kapatılır</h3>
+ * Şema değişirken `<html>` bir kare boyunca `hanui-theme-switching` sınıfını
+ * taşır. Sınıfsız hâlde her yüzey aynı anda ama FARKLI sürelerde animasyon
+ * yapıyordu (kart gölgesi 140 ms, sayfa zemini 200 ms) ve geçiş dalgalı
+ * görünüyordu. Ani geçiş, dalgalı geçişten iyi.
+ *
+ * @example
+ * const { scheme, toggle, isReady } = useHanuiTheme();
+ *
+ * useEffect(() => {
+ *   if (isReady) localStorage.setItem('theme', scheme);
+ * }, [scheme, isReady]);
+ */
+export declare const useHanuiTheme: () => ThemeState;
+
+/**
+ * Alt sayfayi <strong>gorunen</strong> alana yaslar.
+ *
+ * <h3>Neden `dvh` ve `env()` yetmiyor</h3>
+ * `dvh` tarayici cubuklarini hesaba katar ama <em>klavyeyi katmaz</em>;
+ * `env(safe-area-inset-bottom)` ise cihazin centik/ana ekran cubugu payidir, o
+ * da klavyeden habersiz. iOS'ta klavye acildiginda yerlesim gorunum alani hic
+ * degismez: panel oldugu yerde durur, klavye uzerine biner ve alt yarisi —
+ * arama kutusuyla birlikte — erisilemez hale gelir.
+ *
+ * <h3>Android'de ne oluyor</h3>
+ * Tuketici `interactiveWidget: 'resizes-content'` verdiginde orada klavye
+ * yerlesim alanini da kuculttugu icin fark sifir cikar ve bu kanca hicbir sey
+ * degistirmez. Duzeltme iOS icindir, ama olcum platformdan bagimsiz dogru.
+ *
+ * <h3>Degiskenler `<html>` uzerinde</h3>
+ * Panelin kendisine yazilamaz: `::backdrop` ve `<dialog>` ust katmandadir,
+ * ayrica ayni degeri iki farkli panel paylasiyor. Kok ogeye yazmak tek kaynak
+ * birakir.
+ *
+ * @param isActive Panel acik mi. Yalnizca acikken olculur: kendisi yalnizca
+ *   acikken cizilen bir panel varsayilani kullanir, ama sayfa boyunca DOM'da
+ *   duran bir panel bayraksiz cagirdiginda her kullanicida iki gorunum alani
+ *   dinleyicisi bos yere acik kaliyordu.
+ */
+export declare const useSheetViewport: (isActive?: boolean) => void;
+
+export { }