@ahmetilhn/hanui 5.5.0 → 5.6.1

package/build/index.d.ts

@@ -444,6 +444,28 @@ declare const ConfirmDialog_2: FC<Props_50>;
 
 export declare type ConfirmKind = 'destructive' | 'warning' | 'neutral';
 
+export declare const ContextMenu: MemoExoticComponent<({ point, onClose, items, label, header, className, testId, }: ContextMenuProps) => JSX.Element>;
+
+declare type ContextMenuProps = {
+    /**
+     * Açılış noktası — `contextmenu` olayının `clientX` / `clientY`si (görünüm alanı koordinatı).
+     * `null` iken menü kapalı.
+     */
+    point: {
+        x: number;
+        y: number;
+    } | null;
+    /** Escape, Tab, dışarı tıklama ya da seçilen eylemden sonra çağrılır; çağıran `point`i `null` yapar. */
+    onClose: () => void;
+    items: MenuItem[];
+    /** Menünün erişilebilir adı ("Seçim seçenekleri"). */
+    label: string;
+    /** Eylemlerin ÜSTÜNDE okunan bağlam (seçimin özeti, ölçümler) — `role="menu"`nün DIŞINDA. */
+    header?: ReactNode;
+    className?: string;
+    testId?: string;
+};
+
 export declare const CopyField: typeof CopyField_2;
 
 /** Kopyalanabilir teknik değer — tek dokunuşla panoya. */
@@ -897,10 +919,19 @@ export declare type HanuiToken = keyof typeof LIGHT_THEME;
 
 /**
  * `Escape`i tüketecek AÇIK bir yüzey var mı — kipsel pencere, açılır panel, bildirim.
- * ⚠ Sayfa düzeyinde `Escape` dinleyen her kod (sohbetin "akışı durdur" kısayolu gibi) önce bunu
- * sorar. Sormayan bir dinleyici, kullanıcı yalnızca bir modalı kapatmak isterken arkadaki işi de
- * iptal ediyordu. Yüzey kapanırken yığından AYNI olayın içinde değil, bir sonraki render'da
- * çıkar; yani dinleyici o tuş vuruşunda hâlâ `true` görür — istenen de bu.
+ * ⚠ Sayfa düzeyinde `Escape` dinleyen her kod (sohbetin "akışı durdur" kısayolu gibi) İKİSİNİ BİRDEN
+ * sorar: `event.defaultPrevented || hasOpenSurface()`. Sormayan bir dinleyici, kullanıcı yalnızca bir
+ * yüzeyi kapatmak isterken arkadaki işi de iptal ediyordu.
+ * - `Popover`, `Tooltip` ve `Toast` tuşu belge düzeyindeki kendi dinleyicilerinde tüketir, işaretler
+ *   (`preventDefault`) ve AYNI tuş vuruşunda yığından düşer: gerçek tarayıcıda React ayrık olayın
+ *   güncellemesini dinleyiciler arasında boşaltır. Yüzeyin dinleyicisinden SONRA koşan kod (pencerede
+ *   ya da belgede sonradan eklenmiş) burada `false` görür; ona kalan kanıt `defaultPrevented`.
+ *   Ölçüldü (2026-10-27): yardım `Popover`ını kapatan `Escape` bir grafik seçimini de siliyordu.
+ *   jsdom bunu göremez: `fireEvent` betikten gönderilir, dinleyiciler arasında mikro görev
+ *   boşaltılmaz.
+ * - Yüzeyin dinleyicisinden ÖNCE koşan kod işareti göremez ama yığın henüz düşmemiştir: `true`.
+ * - `<dialog>` tabanlı kipsel yüzeyler (`Modal`, `Drawer`, `BottomSheet`, `CommandPalette`) tuş olayı
+ *   bittikten sonra `cancel` ile kapanır: tuş boyunca burada `true`.
  */
 export declare const hasOpenSurface: () => boolean;
 
@@ -1288,6 +1319,13 @@ export declare type PositioningOptions = {
     isOpen: boolean;
 };
 
+declare type PositioningRect = {
+    top: number;
+    left: number;
+    width: number;
+    height: number;
+};
+
 export declare type PositioningState = {
     /** Yüzeye uygulanacak stil — `position: fixed` + hesaplanmış koordinat. */
     style: {
@@ -2612,7 +2650,9 @@ export declare const useListboxNavigation: <T extends HTMLElement = HTMLElement>
  * temeli.
  */
 export declare const usePositioning: (anchorRef: {
-    current: HTMLElement | null;
+    current: {
+        getBoundingClientRect: () => PositioningRect;
+    } | null;
 }, surfaceRef: {
     current: HTMLElement | null;
 }, { side, align, offset, padding, isOpen }: PositioningOptions) => PositioningState;