@mari-ui/native 0.1.0 → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +54 -109
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +14 -22
- package/dist/index.d.ts +14 -22
- package/dist/index.js.map +1 -1
- package/package.json +3 -7
package/dist/index.d.cts
CHANGED
|
@@ -5,7 +5,7 @@ import { ColorRole, Variant, ExtendedSize, Size, Placement } from '@mari-ui/core
|
|
|
5
5
|
import { Theme } from '@mari-ui/tokens';
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
|
-
* Native `skeleton` sözleşmesi — web'deki
|
|
8
|
+
* Native `skeleton` sözleşmesi — web'deki ile aynı: veri gelene kadar
|
|
9
9
|
* component KENDİ geometrisinde (aynı yükseklik, köşe, genişlik) yer tutucu
|
|
10
10
|
* çizer → yüklenince yerleşim kaymaz. Yer tutucu ekran okuyucudan gizlidir.
|
|
11
11
|
* `loading` ≠ `skeleton`: `loading` süren bir EYLEM (Button spinner'ı),
|
|
@@ -1236,7 +1236,7 @@ interface AccordionProps extends SkeletonableProps {
|
|
|
1236
1236
|
destroyOnHidden?: boolean;
|
|
1237
1237
|
style?: StyleProp<ViewStyle>;
|
|
1238
1238
|
}
|
|
1239
|
-
/** Başlık + açılır içerik listesi
|
|
1239
|
+
/** Başlık + açılır içerik listesi. Başlığın her yerine dokunmak açar. */
|
|
1240
1240
|
declare function Accordion({ items, activeKey, defaultActiveKey, onChange, single, variant, size, iconPlacement, expandIcon, destroyOnHidden, skeleton, style, }: Readonly<AccordionProps>): React__default.JSX.Element;
|
|
1241
1241
|
|
|
1242
1242
|
/** `line`: alt çizgili (varsayılan). `card`: kart sekmeler. `pills`: kayan zeminli segmented. */
|
|
@@ -1381,7 +1381,7 @@ interface SelectMultipleProps extends SelectBaseProps {
|
|
|
1381
1381
|
type SelectProps = SelectSingleProps | SelectMultipleProps;
|
|
1382
1382
|
/**
|
|
1383
1383
|
* Seçim alanı: kapalıyken Input'la aynı kutu; dokununca seçenekler
|
|
1384
|
-
* BottomSheet'te açılır
|
|
1384
|
+
* BottomSheet'te açılır. Tekli seçimde dokunulan seçenek
|
|
1385
1385
|
* seçilir ve panel kapanır; çoklu seçimde panel açık kalır ("Tamam" kapatır).
|
|
1386
1386
|
*/
|
|
1387
1387
|
declare function Select(props: SelectProps): React__default.JSX.Element;
|
|
@@ -1459,7 +1459,7 @@ interface ImageProps extends SkeletonableProps {
|
|
|
1459
1459
|
}
|
|
1460
1460
|
|
|
1461
1461
|
/**
|
|
1462
|
-
* Web `Image`ın native
|
|
1462
|
+
* Web `Image`ın native karşılığı: kademeli yükleme
|
|
1463
1463
|
* (bulanık ön izleme → asıl görsel yumuşak geçişle), `fallback`, `preview`
|
|
1464
1464
|
* (tam ekran `ImageViewer`). Kutu yeri önceden ayırır (`aspectRatio` ya da
|
|
1465
1465
|
* `width`/`height`) → yüklenince ekran kaymaz. CDN boyutlandırma `loader` ile:
|
|
@@ -2000,7 +2000,7 @@ interface TreeSelectMultipleProps extends TreeSelectBaseProps {
|
|
|
2000
2000
|
type TreeSelectProps = TreeSelectSingleProps | TreeSelectMultipleProps;
|
|
2001
2001
|
/**
|
|
2002
2002
|
* Ağaçtan değer seçme alanı: kapalıyken Input kutusu; dokununca BottomSheet'te
|
|
2003
|
-
* aşağı inen menü
|
|
2003
|
+
* aşağı inen menü — yol gösterimi, çocuklu satır içeri iner,
|
|
2004
2004
|
* dalın kendisi seviyenin başındaki "(tümü)" satırıyla seçilir. Arama düz
|
|
2005
2005
|
* sonuç listesi (yoluyla). Tekli seçim paneli kapatır; çoklu / onay kutulu
|
|
2006
2006
|
* "Tamam" ile kapanır. Mantık web TreeSelect ile aynı (`treeUtils`).
|
|
@@ -2694,15 +2694,15 @@ declare function NativeConfigProvider({ config, children }: Readonly<{
|
|
|
2694
2694
|
declare function useNativeConfig(): NativeConfig;
|
|
2695
2695
|
|
|
2696
2696
|
/**
|
|
2697
|
-
* Font kipi
|
|
2697
|
+
* Font kipi:
|
|
2698
2698
|
*
|
|
2699
|
-
*
|
|
2700
|
-
*
|
|
2701
|
-
*
|
|
2702
|
-
*
|
|
2699
|
+
* `"system"` (varsayılan): iOS'ta SF, Android'de Roboto. Hiçbir font dosyası
|
|
2700
|
+
* yüklenmesi gerekmez. Token'lardaki aile adları ("Geist"…) kullanılmaz —
|
|
2701
|
+
* yüklenmemiş bir aile iOS'ta geliştirme modunda hata basar, web'de serif'e
|
|
2702
|
+
* düşer (Expo'da gerçek render'da görüldü).
|
|
2703
2703
|
* - `"brand"`: token aileleri (Geist gövde, Manrope başlık, Geist Mono kod).
|
|
2704
|
-
*
|
|
2705
|
-
*
|
|
2704
|
+
* Tüketici dosyaları `expo-font` ile, kayıt adı aile adıyla aynı olacak
|
|
2705
|
+
* şekilde yükler (bkz. `BRAND_FONT_FAMILIES` ve README).
|
|
2706
2706
|
*/
|
|
2707
2707
|
type NativeFonts = "system" | "brand";
|
|
2708
2708
|
/** `"brand"` kipinde yüklenmesi gereken aileler — `useFonts` anahtarları bunlar olmalı. */
|
|
@@ -2731,9 +2731,7 @@ declare function SafeAreaInsetsProvider({ insets, children }: Readonly<{
|
|
|
2731
2731
|
interface ThemeProviderProps {
|
|
2732
2732
|
/**
|
|
2733
2733
|
* `@mari-ui/tokens`'ın `lightTheme`/`darkTheme`'i ya da tüketicinin kendi
|
|
2734
|
-
* ürettiği 3. bir tema
|
|
2735
|
-
* backlog madde 10, "3. tema" ihtiyacı web'de olduğu gibi native'de de
|
|
2736
|
-
* sadece bir `Theme` objesi geçmekten ibaret).
|
|
2734
|
+
* ürettiği 3. bir tema.
|
|
2737
2735
|
*/
|
|
2738
2736
|
theme: Theme;
|
|
2739
2737
|
/**
|
|
@@ -2854,17 +2852,11 @@ interface RecipeMap {
|
|
|
2854
2852
|
};
|
|
2855
2853
|
}
|
|
2856
2854
|
/**
|
|
2857
|
-
* Bildirimsel stil API'si (plan Faz 5): component yazarken elle bir
|
|
2858
|
-
* `StyleSheet.create` objesi kurulmaz, `useStyles("button", { color,
|
|
2859
|
-
* variant, size, ... })` çağrılır — recipe (bkz. `recipes/*.ts`) güncel
|
|
2860
|
-
* temaya (`useTheme()`) göre çözülmüş somut RN stilini döner.
|
|
2861
|
-
*
|
|
2862
2855
|
* Kasıtlı olarak `useMemo` YOK: bu stiller zaten prop'lara göre DEĞİŞKEN —
|
|
2863
2856
|
* klasik "component başına bir kere, modül seviyesinde `StyleSheet.create`"
|
|
2864
2857
|
* paterni burada geçerli değil. Memoization burada gerçek bir performans
|
|
2865
2858
|
* kazancı değil, sadece bağımlılık dizisini elle bakımlı tutma yükü demek
|
|
2866
|
-
* olurdu. İleride profiling gerçekten gerektirdiğini gösterirse eklenir
|
|
2867
|
-
* (bkz. plan backlog madde 18 — component bazlı ince ayar turu).
|
|
2859
|
+
* olurdu. İleride profiling gerçekten gerektirdiğini gösterirse eklenir.
|
|
2868
2860
|
*/
|
|
2869
2861
|
declare function useStyles<K extends keyof RecipeMap>(name: K, options: RecipeMap[K]["options"]): RecipeMap[K]["result"];
|
|
2870
2862
|
|
package/dist/index.d.ts
CHANGED
|
@@ -5,7 +5,7 @@ import { ColorRole, Variant, ExtendedSize, Size, Placement } from '@mari-ui/core
|
|
|
5
5
|
import { Theme } from '@mari-ui/tokens';
|
|
6
6
|
|
|
7
7
|
/**
|
|
8
|
-
* Native `skeleton` sözleşmesi — web'deki
|
|
8
|
+
* Native `skeleton` sözleşmesi — web'deki ile aynı: veri gelene kadar
|
|
9
9
|
* component KENDİ geometrisinde (aynı yükseklik, köşe, genişlik) yer tutucu
|
|
10
10
|
* çizer → yüklenince yerleşim kaymaz. Yer tutucu ekran okuyucudan gizlidir.
|
|
11
11
|
* `loading` ≠ `skeleton`: `loading` süren bir EYLEM (Button spinner'ı),
|
|
@@ -1236,7 +1236,7 @@ interface AccordionProps extends SkeletonableProps {
|
|
|
1236
1236
|
destroyOnHidden?: boolean;
|
|
1237
1237
|
style?: StyleProp<ViewStyle>;
|
|
1238
1238
|
}
|
|
1239
|
-
/** Başlık + açılır içerik listesi
|
|
1239
|
+
/** Başlık + açılır içerik listesi. Başlığın her yerine dokunmak açar. */
|
|
1240
1240
|
declare function Accordion({ items, activeKey, defaultActiveKey, onChange, single, variant, size, iconPlacement, expandIcon, destroyOnHidden, skeleton, style, }: Readonly<AccordionProps>): React__default.JSX.Element;
|
|
1241
1241
|
|
|
1242
1242
|
/** `line`: alt çizgili (varsayılan). `card`: kart sekmeler. `pills`: kayan zeminli segmented. */
|
|
@@ -1381,7 +1381,7 @@ interface SelectMultipleProps extends SelectBaseProps {
|
|
|
1381
1381
|
type SelectProps = SelectSingleProps | SelectMultipleProps;
|
|
1382
1382
|
/**
|
|
1383
1383
|
* Seçim alanı: kapalıyken Input'la aynı kutu; dokununca seçenekler
|
|
1384
|
-
* BottomSheet'te açılır
|
|
1384
|
+
* BottomSheet'te açılır. Tekli seçimde dokunulan seçenek
|
|
1385
1385
|
* seçilir ve panel kapanır; çoklu seçimde panel açık kalır ("Tamam" kapatır).
|
|
1386
1386
|
*/
|
|
1387
1387
|
declare function Select(props: SelectProps): React__default.JSX.Element;
|
|
@@ -1459,7 +1459,7 @@ interface ImageProps extends SkeletonableProps {
|
|
|
1459
1459
|
}
|
|
1460
1460
|
|
|
1461
1461
|
/**
|
|
1462
|
-
* Web `Image`ın native
|
|
1462
|
+
* Web `Image`ın native karşılığı: kademeli yükleme
|
|
1463
1463
|
* (bulanık ön izleme → asıl görsel yumuşak geçişle), `fallback`, `preview`
|
|
1464
1464
|
* (tam ekran `ImageViewer`). Kutu yeri önceden ayırır (`aspectRatio` ya da
|
|
1465
1465
|
* `width`/`height`) → yüklenince ekran kaymaz. CDN boyutlandırma `loader` ile:
|
|
@@ -2000,7 +2000,7 @@ interface TreeSelectMultipleProps extends TreeSelectBaseProps {
|
|
|
2000
2000
|
type TreeSelectProps = TreeSelectSingleProps | TreeSelectMultipleProps;
|
|
2001
2001
|
/**
|
|
2002
2002
|
* Ağaçtan değer seçme alanı: kapalıyken Input kutusu; dokununca BottomSheet'te
|
|
2003
|
-
* aşağı inen menü
|
|
2003
|
+
* aşağı inen menü — yol gösterimi, çocuklu satır içeri iner,
|
|
2004
2004
|
* dalın kendisi seviyenin başındaki "(tümü)" satırıyla seçilir. Arama düz
|
|
2005
2005
|
* sonuç listesi (yoluyla). Tekli seçim paneli kapatır; çoklu / onay kutulu
|
|
2006
2006
|
* "Tamam" ile kapanır. Mantık web TreeSelect ile aynı (`treeUtils`).
|
|
@@ -2694,15 +2694,15 @@ declare function NativeConfigProvider({ config, children }: Readonly<{
|
|
|
2694
2694
|
declare function useNativeConfig(): NativeConfig;
|
|
2695
2695
|
|
|
2696
2696
|
/**
|
|
2697
|
-
* Font kipi
|
|
2697
|
+
* Font kipi:
|
|
2698
2698
|
*
|
|
2699
|
-
*
|
|
2700
|
-
*
|
|
2701
|
-
*
|
|
2702
|
-
*
|
|
2699
|
+
* `"system"` (varsayılan): iOS'ta SF, Android'de Roboto. Hiçbir font dosyası
|
|
2700
|
+
* yüklenmesi gerekmez. Token'lardaki aile adları ("Geist"…) kullanılmaz —
|
|
2701
|
+
* yüklenmemiş bir aile iOS'ta geliştirme modunda hata basar, web'de serif'e
|
|
2702
|
+
* düşer (Expo'da gerçek render'da görüldü).
|
|
2703
2703
|
* - `"brand"`: token aileleri (Geist gövde, Manrope başlık, Geist Mono kod).
|
|
2704
|
-
*
|
|
2705
|
-
*
|
|
2704
|
+
* Tüketici dosyaları `expo-font` ile, kayıt adı aile adıyla aynı olacak
|
|
2705
|
+
* şekilde yükler (bkz. `BRAND_FONT_FAMILIES` ve README).
|
|
2706
2706
|
*/
|
|
2707
2707
|
type NativeFonts = "system" | "brand";
|
|
2708
2708
|
/** `"brand"` kipinde yüklenmesi gereken aileler — `useFonts` anahtarları bunlar olmalı. */
|
|
@@ -2731,9 +2731,7 @@ declare function SafeAreaInsetsProvider({ insets, children }: Readonly<{
|
|
|
2731
2731
|
interface ThemeProviderProps {
|
|
2732
2732
|
/**
|
|
2733
2733
|
* `@mari-ui/tokens`'ın `lightTheme`/`darkTheme`'i ya da tüketicinin kendi
|
|
2734
|
-
* ürettiği 3. bir tema
|
|
2735
|
-
* backlog madde 10, "3. tema" ihtiyacı web'de olduğu gibi native'de de
|
|
2736
|
-
* sadece bir `Theme` objesi geçmekten ibaret).
|
|
2734
|
+
* ürettiği 3. bir tema.
|
|
2737
2735
|
*/
|
|
2738
2736
|
theme: Theme;
|
|
2739
2737
|
/**
|
|
@@ -2854,17 +2852,11 @@ interface RecipeMap {
|
|
|
2854
2852
|
};
|
|
2855
2853
|
}
|
|
2856
2854
|
/**
|
|
2857
|
-
* Bildirimsel stil API'si (plan Faz 5): component yazarken elle bir
|
|
2858
|
-
* `StyleSheet.create` objesi kurulmaz, `useStyles("button", { color,
|
|
2859
|
-
* variant, size, ... })` çağrılır — recipe (bkz. `recipes/*.ts`) güncel
|
|
2860
|
-
* temaya (`useTheme()`) göre çözülmüş somut RN stilini döner.
|
|
2861
|
-
*
|
|
2862
2855
|
* Kasıtlı olarak `useMemo` YOK: bu stiller zaten prop'lara göre DEĞİŞKEN —
|
|
2863
2856
|
* klasik "component başına bir kere, modül seviyesinde `StyleSheet.create`"
|
|
2864
2857
|
* paterni burada geçerli değil. Memoization burada gerçek bir performans
|
|
2865
2858
|
* kazancı değil, sadece bağımlılık dizisini elle bakımlı tutma yükü demek
|
|
2866
|
-
* olurdu. İleride profiling gerçekten gerektirdiğini gösterirse eklenir
|
|
2867
|
-
* (bkz. plan backlog madde 18 — component bazlı ince ayar turu).
|
|
2859
|
+
* olurdu. İleride profiling gerçekten gerektirdiğini gösterirse eklenir.
|
|
2868
2860
|
*/
|
|
2869
2861
|
declare function useStyles<K extends keyof RecipeMap>(name: K, options: RecipeMap[K]["options"]): RecipeMap[K]["result"];
|
|
2870
2862
|
|