@ahmetilhn/hanui 2.0.7 → 2.0.9

package/build/index.d.ts

@@ -372,9 +372,34 @@ export declare const CardFooter: FC<CardSectionProps>;
  * <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.
+ *
+ * <p>Görselin çerçeveyi doldurma biçimi ÇAĞIRANIN kararı ({@link CardMediaFit}):
+ * kütüphane "her ürün fotoğrafı içeriden dursun" gibi bir tercihi kendi
+ * varsayılanına gömmez. Varsayılan `contain` — kırpmayan, yani hiçbir bilgiyi
+ * sessizce yok etmeyen seçenek.
  */
 export declare const CardMedia: FC<CardMediaProps>;
 
+/**
+ * Görselin çerçeveyi NASIL doldurduğu.
+ *
+ * <p>Üçü de aynı soruyu yanıtlıyor — <em>kırpılsın mı, sığsın mı, yoksa
+ * içeriden mi dursun</em> — bu yüzden tek bir prop'un değerleri; ayrı ayrı
+ * boolean'lar olsalardı `isContained={false} isInset` gibi anlamsız
+ * bileşimler yazılabilir hâle gelirdi.
+ *
+ * <ul>
+ *   <li><b>`cover`</b> — çerçeveyi tamamen doldurur, taşan kenarları KIRPAR.
+ *       Kadraj kenara kadar anlamlı olan fotoğraflar (kampanya, kapak).</li>
+ *   <li><b>`contain`</b> — kırpmadan sığdırır; uzun kenarı çerçeve dolgusuna
+ *       dayanır. Karışık oranlarda gelen görseller.</li>
+ *   <li><b>`inset`</b> — sığdırır ve <b>%85</b>e çekip merkezler. Şeffaf
+ *       zeminli ürün fotoğrafları: parçanın kenarı kartın kenarına
+ *       değmiyor.</li>
+ * </ul>
+ */
+export declare type CardMediaFit = 'cover' | 'contain' | 'inset';
+
 declare type CardMediaProps = {
     children: ReactNode;
     /** Genişlik / yükseklik oranı. Sabit oran yükleme sırasında kaymayı önler. */
@@ -383,7 +408,14 @@ declare type CardMediaProps = {
     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). */
+    /** Görsel çerçeveyi nasıl doldurur — bkz. {@link CardMediaFit}. */
+    fit?: CardMediaFit;
+    /**
+     * @deprecated `fit` kullanın: `isContained` → `fit="contain"`,
+     * `isContained={false}` → `fit="cover"`. Boolean yalnızca iki durumu
+     * anlatabiliyordu, üçüncüsü (`inset`) ona sığmadı. Eski yol bir sürüm daha
+     * çalışır; `docs/MIGRATION.md`.
+     */
     isContained?: boolean;
     className?: string;
 };