@mari-ui/native 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Aykut Yılmaz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,89 @@
-# Temporary Holding Version
+# @mari-ui/native
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+[mari-ui](https://github.com/aykutyilmaz37/mari-ui) tasarım sisteminin React Native component'leri. Web'deki `@mari-ui/components` ile aynı prop adları, aynı tema ve renk sözleşmesi; ölçüler ise dokunmatik ekrana göre (en az 44 pt dokunma hedefi, platform metin ölçeği).
+
+- **~45 component** — form, gezinme, veri gösterimi, katmanlar (Modal, BottomSheet, Toast), görsel galerisi.
+- **Sıfır kurulum** — `StyleSheet` + `@mari-ui/tokens`; NativeWind, babel ya da metro eklentisi gerekmez.
+- **Açık / koyu tema** otomatik (işletim sistemi tercihi), WCAG AA kontrastı token'lardan.
+- Her component'te **iskelet** (`skeleton`), erişilebilirlik (rol, ad, durum) ve hareket azaltma desteği.
+
+## Kurulum
+
+```bash
+pnpm add @mari-ui/native @mari-ui/tokens react-native-svg
+```
+
+Peer bağımlılıklar: `react` ≥ 18.2, `react-native` ≥ 0.76, `react-native-svg` ≥ 15. Expo ile `npx expo install react-native-svg` kullanın.
+
+## Kullanım
+
+```tsx
+import { Button, Input, Field } from "@mari-ui/native";
+
+<Field label="E-posta">
+  <Input type="email" placeholder="ornek@mari-ui.com" />
+</Field>
+<Button color="primary" onPress={save}>Kaydet</Button>
+```
+
+`ThemeProvider` isteğe bağlıdır; verilmezse tema cihazın açık/koyu ayarını izler.
+
+## Tema
+
+```tsx
+import { ThemeProvider } from "@mari-ui/native";
+import { darkTheme, resolveThemeConfig } from "@mari-ui/tokens";
+
+// Her zaman koyu:
+<ThemeProvider theme={darkTheme}><App /></ThemeProvider>
+
+// Projenin mari-ui.config.json'ı (marka rengi, kişilik, ek temalar):
+const { light, dark } = resolveThemeConfig(config);
+<ThemeProvider theme={scheme === "dark" ? dark : light}><App /></ThemeProvider>
+```
+
+`npx @mari-ui/cli theme` aynı config'ten `mari-ui-theme.ts` üretir; içindeki temalar doğrudan `ThemeProvider`a verilebilir.
+
+### Fontlar
+
+Varsayılan `fonts="system"`: iOS'ta SF, Android'de Roboto — dosya yüklemek gerekmez. mari-ui'ın kendi aileleri için `fonts="brand"` verin ve fontları aynı adlarla yükleyin:
+
+```tsx
+import { useFonts } from "expo-font";
+
+const [loaded] = useFonts({
+  Geist: require("@mari-ui/tokens/fonts/Geist.ttf"),
+  Manrope: require("@mari-ui/tokens/fonts/Manrope.ttf"),
+  "Geist Mono": require("@mari-ui/tokens/fonts/GeistMono.ttf"),
+});
+
+<ThemeProvider theme={theme} fonts="brand">…</ThemeProvider>
+```
+
+Tasarım kişilikleri renk, köşe, gölge ve hareketi uygular; native'de font dosyası getirmez.
+
+### Güvenli alan ve ölçüler
+
+```tsx
+import { NativeConfigProvider, ThemeProvider } from "@mari-ui/native";
+import { useSafeAreaInsets } from "react-native-safe-area-context";
+
+<ThemeProvider theme={theme} insets={useSafeAreaInsets()}>
+  <NativeConfigProvider config={{ sizes: { md: { height: 48 } } }}>
+    <App />
+  </NativeConfigProvider>
+</ThemeProvider>
+```
+
+`insets`, ekran kenarına değen bileşenlere (AppBar, BottomNavigation, BottomSheet, Toast…) çentik ve ev çubuğu payını verir. `NativeConfigProvider` varsayılan ölçüleri (yükseklik, dolgu, yazı boyutu) uygulama genelinde ezer; yalnız verilen alanlar değişir.
+
+## İpucu: klavye ve kaydırma
+
+Select / BottomSheet / Modal açan ekranın `ScrollView`una `keyboardShouldPersistTaps="handled"` verin; yoksa klavye açıkken paneldeki ilk dokunuş yalnız klavyeyi kapatır.
+
+## Bağlantılar
+
+- Component dokümanları ve örnekler: [mari-ui deposu](https://github.com/aykutyilmaz37/mari-ui#readme) (Storybook: `pnpm storybook`, "Native" grubu)
+- Web component'leri: [`@mari-ui/components`](https://www.npmjs.com/package/@mari-ui/components)
+
+Lisans: MIT.