@qumra/fanar-native 0.1.0 → 0.1.1

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.
Files changed (2) hide show
  1. package/README.md +12 -76
  2. package/package.json +1 -2
package/README.md CHANGED
@@ -1,83 +1,19 @@
1
1
  # @qumra/fanar-native
2
2
 
3
- مكتبة مكوّنات قمرة لـReact Native — النظير النيتف لـ`@qumra/fanar`.
4
-
5
- نفس التوكنز، ونفس أسماء المكوّنات، ونفس أسماء الخصائص — بتنفيذ مكتوب
6
- لـReact Native لا مترجَم عنه. بلا تبعيّات وقت تشغيل.
7
-
8
- ```tsx
9
- import { FanarProvider, Screen, Card, Button, Text } from '@qumra/fanar-native'
10
-
11
- <FanarProvider mode="system" lang="ar">
12
- <Screen>
13
- <Card padded>
14
- <Text size="h3" weight="black">مرحباً</Text>
15
- <Button variant="primary" onPress={save}>احفظ</Button>
16
- </Card>
17
- </Screen>
18
- </FanarProvider>
19
- ```
20
-
21
- ## التركيب
22
-
23
3
  ```bash
24
4
  npm i @qumra/fanar-native
25
5
  ```
26
6
 
27
- نظائر مطلوبة: `react` · `react-native` · `lucide-react-native` ·
28
- `react-native-safe-area-context` · `react-native-svg`.
29
-
30
- ثمّ:
31
-
32
- 1. ركّب `<SafeAreaProvider>` عند جذر التطبيق.
33
- 2. ركّب `<FanarProvider>` تحته.
34
- 3. ضع ملفّات الأسكندرية الثمانية في `src/assets/fonts` وشغّل
35
- `npx react-native-asset`. (أو مرّر `fonts={SYSTEM_FONT}` وخذ خطّ
36
- النظام.)
37
-
38
- `DrawerMenu` **محتوى** لا مُلاحِظ: يرسم الأقسام ويصرف الاختيار، ولا
39
- يعرف شيئاً عن `@react-navigation/drawer`. مرّره إلى `drawerContent`.
40
-
41
- ## الاتجاه
42
-
43
- `FanarProvider` يضع `direction` على View جذرٍ **`flex: 1`**، فكلّ ما تحته
44
- — الخصائص المنطقية، و`flexDirection: 'row'`، ومحاذاة النصّ، والأسهم
45
- المعكوسة — يتبع `lang` فوراً، بلا إعادة تشغيل. لذلك:
46
-
47
- - ضعه **فوق** `NavigationContainer`، لتقع الشاشات كلّها تحته.
48
- - لا تستدعِ `I18nManager.forceRTL(true)` لتطبيقٍ يبدّل لغته.
49
- - هيدر `react-navigation` وإيماءة الرجوع يقرآن `I18nManager` مباشرةً:
50
- مرّر `<NavigationContainer direction={dir}>` (React Navigation 7)،
51
- و`dir` من `useLang()`.
7
+ Peers: `react` · `react-native` · `lucide-react-native` ·
8
+ `react-native-safe-area-context` · `react-native-svg`
52
9
 
53
- ## ما في الحزمة
54
-
55
- **الأساس** — `FanarProvider` · `useFanar` · `useTheme` · `useLang` ·
56
- `buildTheme` · `TOKENS` · `DARK_TOKENS` · `icon()`
57
-
58
- **النصّ والأزرار** — `Text` · `Button` · `IconButton`
59
-
60
- **العرض** — `Badge` · `Counter` · `Avatar` · `Card` · `CardHeader` ·
61
- `PageHeader` · `StatCard` · `Progress` · `ProgressSteps` · `Skeleton` ·
62
- `Divider`
63
-
64
- **الحقول** — `Field` · `Input` · `SearchInput` · `Textarea` · `Select` ·
65
- `Checkbox` · `Radio` · `RadioGroup` · `Switch` · `NumberStepper`
66
-
67
- **التنقّل** — `Tabs` · `FilterChips` · `Accordion` · `Timeline` ·
68
- `Stepper`
69
-
70
- **الطبقات** — `Sheet` · `SheetRow` · `Modal` · `Alert` · `EmptyState` ·
71
- `toast` · `ToastHost` · `Tooltip`
72
-
73
- **القشرة** — `Screen` · `AppHeader` · `BottomTabBar` · `DrawerMenu`
74
-
75
- **أسطح قمرة** — `Hero` · `PromptCard` · `ListRow` · `StepRow` ·
76
- `RuleGrid` · `Glow`
77
-
78
- **المال والتقييم** — `Money` · `MoneyProvider` · `useCurrency` ·
79
- `Stars` · `RatingInput`
80
-
81
- **اللغة** — `translate` · `phrase` · `DICT`
82
-
83
- `@qumra/fanar-native/tokens` — القيم وحدها، بلا مكوّنات.
10
+ ```tsx
11
+ import { SafeAreaProvider } from 'react-native-safe-area-context'
12
+ import { FanarProvider } from '@qumra/fanar-native'
13
+
14
+ <SafeAreaProvider>
15
+ <FanarProvider lang="ar">
16
+ <App />
17
+ </FanarProvider>
18
+ </SafeAreaProvider>
19
+ ```
package/package.json CHANGED
@@ -1,7 +1,6 @@
1
1
  {
2
2
  "name": "@qumra/fanar-native",
3
- "version": "0.1.0",
4
- "description": "Qumra's React Native component library — the native sibling of @qumra/fanar. Token-driven, RTL-first, zero runtime dependencies.",
3
+ "version": "0.1.1",
5
4
  "license": "UNLICENSED",
6
5
  "keywords": [
7
6
  "qumra",