@ahmetilhn/hanui 2.8.0 → 3.2.0

package/build/index.d.ts

@@ -49,6 +49,12 @@ export declare type AlertTone = 'info' | 'success' | 'warning' | 'danger';
 /** Duyurunun aciliyeti. */
 export declare type AnnouncePoliteness = 'polite' | 'assertive';
 
+/**
+ * Ezmeleri belgeye yazar. Aynı `<style>` etiketi tekrar kullanılır: her
+ * çağrıda yeni bir etiket eklemek, birbirini ezen onlarca blok bırakıyordu.
+ */
+export declare const applyThemeConfig: (config: HanuiThemeConfig | undefined) => void;
+
 export declare const Avatar: typeof Avatar_2;
 
 /** Avatar — kullanıcı madalyonu. */
@@ -284,6 +290,7 @@ export declare const Checkbox: typeof Checkbox_2;
 /** Onay kutusu. */
 declare const Checkbox_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
 label: ReactNode;
+/** Etiketin altındaki açıklama; `aria-describedby` ile bağlanır. */
 hint?: string;
 testId?: string;
 } & RefAttributes<HTMLInputElement>>;
@@ -354,7 +361,7 @@ declare type CircleProps = {
 export declare const Combobox: typeof Combobox_2;
 
 /** Aranabilir seçim kutusu. */
-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, }: ComboboxProps<T>) => JSX.Element;
+declare const Combobox_2: <T extends string>({ options, value, onChange, labels, isSearchHidden, onSearch, isLoading, isDisabled, isClearable, icon, id, required, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: ComboboxProps<T>) => JSX.Element;
 
 /** Bileşenin çizdiği metinler. */
 export declare type ComboboxLabels = {
@@ -400,6 +407,8 @@ declare type ComboboxProps<T extends string> = {
     /** Tetikleyicinin solundaki ikon. */
     icon?: ReactNode;
     id?: string;
+    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. Bkz. `Select.required`. */
+    required?: boolean;
     'aria-describedby'?: string;
     'aria-invalid'?: boolean;
     className?: string;
@@ -529,6 +538,12 @@ export declare type DateRangeValue = {
 /** Kütüphanenin varsayılan font yığınları — hepsi sistem fontlarına iner. */
 export declare const DEFAULT_FONTS: Required<HanuiFonts>;
 
+/**
+ * Bilgi yoğunluğunun taşındığı öznitelik.
+ * `<html data-hanui-density="compact">`.
+ */
+export declare const DENSITY_ATTRIBUTE = "data-hanui-density";
+
 export declare const Directory: typeof Directory_2;
 
 /**
@@ -772,6 +787,49 @@ export declare type HanuiLabels = Partial<{
         copied: Formatter<[value: string]>;
         announcement: string;
     }>;
+    /**
+     * Dosya yukleme.
+     *
+     * ⚠ `tooLarge` bir BICIMLENDIRICI: mesaj dosya adini ve siniri TASIMALI.
+     * Sabit bir "cok buyuk" metni, on dosyalik bir listede hangisinin
+     * reddedildigini soylemiyordu.
+     */
+    fileUpload: Partial<{
+        tooLarge: Formatter<[name: string, max: string]>;
+        /** Yukleme sirasindaki ekran okuyucu duyurusu. */
+        uploading: Formatter<[name: string]>;
+        /** Dosya secildiginde yapilan duyuru. */
+        added: Formatter<[count: number]>;
+    }>;
+    /**
+     * Sayisal gostergenin YON metni.
+     *
+     * ⚠ Uc deger de SR-ONLY: ok isareti gorsel bir sinyal ve ekran okuyucuya
+     * hicbir sey soylemiyor. Verilmezse gosterge "yuzde 12" der, artis mi
+     * azalis mi belirsiz kalir.
+     */
+    stat: Partial<{
+        increase: string;
+        decrease: string;
+        unchanged: string;
+    }>;
+    /** Adim gostergesinin DURUM metinleri — hepsi sr-only. */
+    steps: Partial<{
+        completed: string;
+        current: string;
+        upcoming: string;
+    }>;
+    /** Zaman cizelgesinin DURUM metinleri — hepsi sr-only. */
+    timeline: Partial<{
+        completed: string;
+        current: string;
+        failed: string;
+    }>;
+    /** Etiket girisi. `removed` bir bicimlendirici: hangi etiketin kalktigi. */
+    tagInput: Partial<{
+        added: Formatter<[value: string]>;
+        removed: Formatter<[value: string]>;
+    }>;
     rating: Partial<{
         /** Yıldızların ekran okuyucu karşılığı ("5 üzerinden 4,5 — 12 değerlendirme"). */
         srLabel: Formatter<[value: number, count: number | undefined]>;
@@ -947,9 +1005,6 @@ isTechnical?: boolean;
 testId?: string;
 } & RefAttributes<HTMLInputElement>>;
 
-/** Odaklanınca mobilde ekran klavyesini açacak bir öğe mi? */
-export declare const isKeyboardOpeningElement: (element: Element | null) => boolean;
-
 /** AÇIK TEMA — varsayılan. */
 export declare const LIGHT_THEME: {
     readonly page: "#ffffff";
@@ -1258,12 +1313,6 @@ export declare type PositioningState = {
 /** Yüzeyin tercih ettiği kenar. Yer yoksa karşıtına düşer. */
 export declare type PositionSide = 'top' | 'bottom' | 'left' | 'right';
 
-/**
- * `showModal()` ÇAĞRILDIKTAN SONRA çağrılır. Odak bir metin alanına düştüyse
- * panelin kendisine geri alınır; düşmediyse hiçbir şey yapılmaz.
- */
-export declare const preventAutoKeyboard: (dialog: HTMLDialogElement) => void;
-
 export declare const Price: typeof Price_2;
 
 /** Tutar gösterimi. */
@@ -1383,6 +1432,8 @@ declare type Props_14 = {
     maxTags?: number;
     isDisabled?: boolean;
     id?: string;
+    /** Zorunluluk — `Field`in `FieldChildProps` sözleşmesi. Bkz. `Select.required`. */
+    required?: boolean;
     'aria-describedby'?: string;
     'aria-invalid'?: boolean;
     className?: string;
@@ -2055,6 +2106,18 @@ declare type Props_8<T extends string> = {
     align?: 'start' | 'end';
     isDisabled?: boolean;
     id?: string;
+    /**
+     * Zorunluluk — `Field`in `FieldChildProps` sözleşmesinden gelir.
+     *
+     * ⚠ Bileşen `...rest` YAYMIYOR, yani `Props`ta bildirilmeyen her alan
+     * sessizce buharlaşır. `required` bir dönem tam olarak öyleydi: `<Field
+     * isRequired>{props => <Select {...props} …/>}</Field>` yazan çağıran
+     * görsel `*` ve sr-only "(zorunlu)" alıyor ama KONTROLDE hiçbir işaret
+     * olmuyordu — doğrudan kutuya atlayan ekran okuyucu kullanıcısı alanın
+     * zorunlu olduğunu hiç duymuyordu. `props` taze bir nesne literali olmadığı
+     * için TypeScript'in fazla-özellik denetimi de uyarmıyordu.
+     */
+    required?: boolean;
     'aria-describedby'?: string;
     'aria-invalid'?: boolean;
     className?: string;
@@ -2082,6 +2145,7 @@ export declare const Radio: typeof Radio_2;
 /** Radyo düğmesi. */
 declare const Radio_2: ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "type"> & {
 label: ReactNode;
+/** Etiketin altındaki açıklama; `aria-describedby` ile bağlanır. */
 hint?: string;
 /** Sağda gösterilen sonuç adedi (filtre listelerinde). */
 count?: number;
@@ -2184,7 +2248,7 @@ export declare type SegmentOption<T extends string = string> = {
 export declare const Select: typeof Select_2;
 
 /** Seçim kutusu. */
-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_8<T>) => JSX.Element;
+declare const Select_2: <T extends string>({ options, value, onChange, label, placeholder, closeLabel, icon, size, align, isDisabled, id, className, testId, required, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_8<T>) => JSX.Element;
 
 export declare type SelectOption<T extends string = string> = {
     value: T;
@@ -2321,7 +2385,7 @@ declare const Tabs_2: FC<Props_37>;
 export declare const TagInput: typeof TagInput_2;
 
 /** Etiket girdisi — yazılan metni kaldırılabilir çiplere çevirir. */
-declare const TagInput_2: ({ values, onChange, label, placeholder, removeLabel, separators, maxTags, isDisabled, id, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_14) => JSX.Element;
+declare const TagInput_2: ({ values, onChange, label, placeholder, removeLabel, separators, maxTags, isDisabled, id, required, className, testId, "aria-describedby": describedBy, "aria-invalid": isInvalid, }: Props_14) => JSX.Element;
 
 export declare const Textarea: typeof Textarea_2;
 
@@ -2341,6 +2405,9 @@ export declare const TextLink: typeof TextLink_2;
 /** Metin bağlantısı. */
 declare const TextLink_2: ({ href, children, hasArrow, tone, size, className, linkProps, ...rest }: Props_2) => JSX.Element;
 
+/** Temanın taşındığı öznitelik. `<html data-hanui-theme="dark">`. */
+export declare const THEME_ATTRIBUTE = "data-hanui-theme";
+
 export declare const Tile: typeof Tile_2;
 
 /** Karo — ikon madalyonu + etiket. */
@@ -2494,18 +2561,6 @@ export declare const usePositioning: (anchorRef: {
     current: HTMLElement | null;
 }, { side, align, offset, padding, isOpen }: PositioningOptions) => PositioningState;
 
-export declare const useScrollLock: (isLocked?: boolean) => void;
-
-/**
- * Alt sayfayi <strong>gorunen</strong> alana yaslar.
- *
- * @param isActive Panel acik mi. Yalnizca acikken olculur: kendisi yalnizca
- * acikken cizilen bir panel varsayilani kullanir, ama sayfa boyunca DOM'da
- * duran bir panel bayraksiz cagirdiginda her kullanicida iki gorunum alani
- * dinleyicisi bos yere acik kaliyordu.
- */
-export declare const useSheetViewport: (isActive?: boolean) => void;
-
 /** SANALLAŞTIRMA — yalnızca görünen satırları çiz. */
 export declare const useVirtualList: (count: number, { rowHeight, overscan, isEnabled }?: {
     rowHeight?: number | undefined;