@alebtz/redm-vue-ui 1.0.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 ADDED
@@ -0,0 +1,122 @@
1
+ # RedM Vue UI
2
+
3
+ A Vue 3 UI Component Library inspired by Red Dead Redemption styling for RedM NUI interfaces.
4
+
5
+ ## 📦 Installation
6
+
7
+ ```bash
8
+ npm install @alebtz/redm-vue-ui
9
+ ```
10
+
11
+ ## 🚀 Quick Start
12
+
13
+ ```js
14
+ import { createApp } from 'vue'
15
+ import RedmVueUI from '@alebtz/redm-vue-ui'
16
+ import '@alebtz/redm-vue-ui/style.css'
17
+
18
+ const app = createApp(App)
19
+ app.use(RedmVueUI)
20
+ app.mount('#app')
21
+ ```
22
+
23
+ ### Or import components individually
24
+
25
+ ```js
26
+ import { RdrButton, RdrCard, RdrInput } from '@alebtz/redm-vue-ui'
27
+ import '@alebtz/redm-vue-ui/style.css'
28
+ ```
29
+
30
+ ## 📚 Components
31
+
32
+ ### Base Components
33
+ - **RdrButton** - Styled button with RDR textures
34
+ - **RdrInput** - Text input field
35
+ - **RdrTextarea** - Multi-line text area
36
+ - **RdrCard** - Content card with vintage styling
37
+ - **RdrHeader** - Header with decorative red divider
38
+ - **RdrDivider** - Horizontal separator
39
+ - **RdrSlider** - Range slider control
40
+
41
+ ### Layout Components
42
+ - **RdrPanel** - Main panel with background texture
43
+ - **RdrModal** - Centered modal with backdrop
44
+ - **RdrScrollArea** - Scrollable area with custom scrollbar
45
+
46
+ ### Transitions
47
+ - **RdrZoomTransition** - Zoom and fade animation
48
+ - **RdrSlideTransition** - Slide from bottom animation
49
+ - **RdrFadeTransition** - Simple fade animation
50
+
51
+ ### Composables
52
+ - **useRdrTheme** - Access theme colors and variables
53
+ - **useRdrAnimations** - Animation utilities
54
+
55
+ ## 🎨 Customization
56
+
57
+ The library uses CSS custom properties for easy theming:
58
+
59
+ ```css
60
+ :root {
61
+ --rdr-color-primary: #B62A2A;
62
+ --rdr-color-text: #fafafa;
63
+ --rdr-color-overlay: rgba(33, 33, 33, 0.3);
64
+ --rdr-font-title: 'Chinese Rocks', serif;
65
+ --rdr-font-heading: 'RDR Lino Regular', serif;
66
+ --rdr-font-body: 'Hapna Slab Serif', serif;
67
+ }
68
+ ```
69
+
70
+ ## 📖 Usage Examples
71
+
72
+ ### Button
73
+ ```vue
74
+ <RdrButton @click="handleClick">
75
+ Click Me
76
+ </RdrButton>
77
+ ```
78
+
79
+ ### Card with Header
80
+ ```vue
81
+ <RdrCard>
82
+ <RdrHeader>Patient Details</RdrHeader>
83
+ <p>Card content here...</p>
84
+ </RdrCard>
85
+ ```
86
+
87
+ ### Modal
88
+ ```vue
89
+ <RdrModal v-model="isOpen">
90
+ <RdrHeader>Confirmation</RdrHeader>
91
+ <p>Are you sure?</p>
92
+ <RdrButton @click="isOpen = false">Close</RdrButton>
93
+ </RdrModal>
94
+ ```
95
+
96
+ ### Input
97
+ ```vue
98
+ <RdrInput
99
+ v-model="text"
100
+ placeholder="Enter text..."
101
+ />
102
+ ```
103
+
104
+ ## 🛠️ Development
105
+
106
+ ```bash
107
+ # Install dependencies
108
+ npm install
109
+
110
+ # Start development server
111
+ npm run dev
112
+
113
+ # Build library
114
+ npm run build
115
+
116
+ # Build in watch mode
117
+ npm run build:watch
118
+ ```
119
+
120
+ ## 📄 License
121
+
122
+ MIT License - feel free to use in your RedM projects!