react-native-games 0.3.0

package/LICENSE

@@ -0,0 +1,66 @@
+DUAL LICENSE
+
+Copyright (c) 2025 Niranjan Devasani
+
+This software is available under two different licenses:
+
+================================================================================
+1. NON-COMMERCIAL LICENSE (Free)
+================================================================================
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to use
+the Software for NON-COMMERCIAL purposes only, subject to the following conditions:
+
+- The Software may be used, copied, modified, and distributed for personal,
+  educational, research, or other non-commercial purposes.
+- Commercial use, including but not limited to selling, licensing, or 
+  incorporating the Software into commercial products or services, is 
+  strictly prohibited under this license.
+- 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.
+
+================================================================================
+2. COMMERCIAL LICENSE (Paid)
+================================================================================
+
+For commercial use, including but not limited to:
+- Incorporating the Software into commercial applications
+- Selling products or services that include the Software
+- Using the Software in revenue-generating projects
+- Distribution as part of commercial software packages
+
+A separate commercial license must be obtained by contacting:
+
+Email: niranjan.devasani@gmail.com
+Subject: React Native Games - Commercial License Request
+
+Commercial licensing includes:
+- Full commercial usage rights
+- Priority support and maintenance
+- Custom feature development consideration
+- Removal of attribution requirements (optional)
+
+================================================================================
+DEFINITIONS
+================================================================================
+
+"Commercial use" means any use of the Software that is primarily intended for
+or directed toward commercial advantage or monetary compensation. This includes,
+but is not limited to:
+- Use in commercial applications or products
+- Use by commercial entities for business purposes
+- Use in applications that generate revenue through sales, subscriptions, 
+  advertising, or any other monetization method
+
+"Non-commercial use" means use for personal, educational, research, or other
+purposes that are not primarily intended for or directed toward commercial
+advantage or monetary compensation.

package/README.md

@@ -0,0 +1,269 @@
+# 🎮 react-native-games
+
+**react-native-games** is a collection of free, high-performance games for your React Native projects. Built with modern React Native technologies including Skia, Reanimated, and TypeScript for smooth 60fps gameplay.
+
+## 🎯 Available Games
+
+| Game | Description | Features |
+|------|-------------|----------|
+| **🐱 Cat Popper** | Classic whack-a-mole with cute cats | Multiple difficulty levels, customizable grid sizes, haptic feedback |
+| **🎈 Balloon Blaster** | Pop balloons rising from the bottom | Physics-based gameplay, particle effects, combo system |
+| **🍎 Fruit Slicer** | Slice fruits and avoid bombs | Physics-based gameplay, particle effects, combo system |
+| **🧩 Maze Runner** | Navigate through procedurally generated mazes | Dynamic maze generation, timer challenges, multiple difficulties |
+| **🚀 Space Traveller** | Dodge asteroids in space | 3D-style graphics, progressive difficulty, space physics |
+
+## 📦 Installation
+
+```sh
+npm install react-native-games
+# or
+yarn add react-native-games
+```
+
+## 🔧 Peer Dependencies
+
+This library requires the following peer dependencies to be installed in your project:
+
+```sh
+# Core React Native Skia for high-performance graphics
+npm install @shopify/react-native-skia
+
+# Reanimated for smooth animations
+npm install react-native-reanimated
+
+# Gesture Handler for touch interactions
+npm install react-native-gesture-handler
+
+# Worklets for performance (used by Reanimated)
+npm install react-native-worklets
+```
+
+### Platform Setup
+
+Follow the installation guides for each peer dependency:
+
+- **[@shopify/react-native-skia](https://shopify.github.io/react-native-skia/docs/getting-started/installation)** - Graphics rendering
+- **[react-native-reanimated](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started)** - Animations
+- **[react-native-gesture-handler](https://docs.swmansion.com/react-native-gesture-handler/docs/fundamentals/installation)** - Gestures
+
+## 🚀 Usage
+
+### Basic Implementation
+
+```tsx
+import React, { useState } from 'react';
+import { View, StyleSheet } from 'react-native';
+import { CatPopper, BalloonBlaster, FruitSlicer, MazeRunner, SpaceTraveller } from 'react-native-games';
+
+export default function GameScreen() {
+  const [showSettings, setShowSettings] = useState(false);
+
+  return (
+    <View style={styles.container}>
+      {/* Cat Popper Game - Classic whack-a-mole with cats */}
+      <CatPopper
+        showSettingsModal={showSettings}
+        onToggleSettingsModal={() => setShowSettings(!showSettings)}
+      />
+
+      {/* Or choose any other game */}
+      {/* <BalloonBlaster /> */}
+      {/* <FruitSlicer /> */}
+      {/* <MazeRunner /> */}
+      {/* <SpaceTraveller /> */}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: {
+    flex: 1,
+    backgroundColor: '#1a1a2e'
+  }
+});
+```
+
+### Game-Specific Props & Default Settings
+
+#### Cat Popper
+```tsx
+<CatPopper
+  showSettingsModal={boolean}           // Control settings modal visibility
+  onToggleSettingsModal={() => void}    // Settings modal toggle callback
+/>
+
+// Default Settings:
+// {
+//   difficulty: 'medium',          // Balanced challenge
+//   soundEnabled: true,            // Audio feedback enabled
+//   hapticEnabled: true,           // Haptic feedback enabled
+//   gameDuration: 120              // Auto-set based on difficulty (Easy: 60s, Medium: 120s, Hard: 180s)
+// }
+// Available: difficulty ['easy','medium','hard']
+// Cat spawn intervals: easy 2000ms, medium 1500ms, hard 1000ms
+// Cat visible duration: easy 2500ms, medium 2000ms, hard 1500ms
+// Grid sizes: easy/medium 3x3, hard 4x4
+```
+
+#### Balloon Blaster
+```tsx
+<BalloonBlaster
+  showSettingsModal={boolean}           // Control settings modal visibility
+  onToggleSettingsModal={() => void}    // Settings modal toggle callback
+/>
+
+// Default Settings:
+// {
+//   difficulty: 'medium',          // Balanced challenge
+//   soundEnabled: true,            // Audio feedback enabled
+//   hapticEnabled: true,           // Haptic feedback enabled
+//   gameDuration: 120              // Auto-set based on difficulty (Easy: 60s, Medium: 120s, Hard: 180s)
+// }
+// Available: difficulty ['easy','medium','hard']
+// Balloons rise from bottom to top with physics-based movement
+// Spawn intervals and speeds adjust automatically with difficulty
+```
+
+#### Fruit Slicer
+```tsx
+<FruitSlicer
+  showSettingsModal={boolean}           // Control settings modal visibility
+  onToggleSettingsModal={() => void}    // Settings modal toggle callback
+/>
+
+// Default Settings:
+// {
+//   difficulty: 'medium',          // Balanced challenge
+//   soundEnabled: true,            // Audio feedback enabled
+//   hapticEnabled: true,           // Haptic feedback enabled
+//   gameDuration: 120              // Auto-set based on difficulty (Easy: 60s, Medium: 120s, Hard: 180s)
+// }
+// Available: difficulty ['easy','medium','hard']
+// Spawn intervals: easy 2000ms, medium 1500ms, hard 1000ms
+```
+
+#### Maze Runner
+```tsx
+<MazeRunner
+  showSettingsModal={boolean}           // Control settings modal visibility
+  onToggleSettingsModal={() => void}    // Settings modal toggle callback
+/>
+
+// Default Settings:
+// {
+//   difficulty: 'medium',          // Balanced challenge
+//   soundEnabled: true,            // Audio feedback enabled
+//   hapticEnabled: true,           // Haptic feedback enabled
+//   gameDuration: 120,             // Auto-set based on difficulty (Easy: 60s, Medium: 120s, Hard: 180s)
+//   gridSize: 10,                  // 10x10 maze grid (auto-adjusts with difficulty)
+//   showHints: false               // No hints by default
+// }
+// Available: difficulty ['easy','medium','hard']
+// Grid sizes: easy 8x8, medium 10x10, hard 12x12 (auto-adjusts with difficulty)
+// Procedurally generated mazes with intelligent pathfinding
+```
+
+#### Space Traveller
+```tsx
+<SpaceTraveller
+  showSettingsModal={boolean}           // Control settings modal visibility
+  onToggleSettingsModal={() => void}    // Settings modal toggle callback
+/>
+
+// Default Settings:
+// {
+//   difficulty: 'medium',          // Balanced challenge
+//   soundEnabled: true,            // Audio feedback enabled
+//   hapticEnabled: true,           // Haptic feedback enabled
+//   gameDuration: 120,             // Auto-set based on difficulty (Easy: 60s, Medium: 120s, Hard: 180s)
+//   asteroidSpawnInterval: 3000,   // 3 seconds between asteroid pairs
+//   asteroidSpeed: 2               // Movement speed multiplier
+// }
+// Available: difficulty ['easy','medium','hard']
+// Horizontal drag controls with collision immunity system
+// Progressive difficulty with faster asteroids and shorter spawn intervals
+```
+
+### Game Settings
+
+Each game includes built-in settings screens with a unified, simplified interface:
+
+- **Difficulty Levels**: Easy (60s), Medium (120s), Hard (180s) - automatically sets game duration
+- **Sound Effects**: Toggle audio feedback on/off
+- **Haptic Feedback**: Toggle vibration feedback on/off
+
+All games use a centralized settings system for consistency and ease of maintenance.
+
+## 🎨 Features
+
+### 🚀 **High Performance**
+- Built with React Native Skia for 60fps gameplay
+- Optimized animations using Reanimated 3
+- Efficient rendering and memory management
+
+### 🎵 **Rich Audio & Haptics**
+- Sound effects and speech synthesis
+- Haptic feedback for immersive experience
+- Configurable audio settings
+
+### 🎯 **Customizable**
+- Multiple difficulty levels
+- Adjustable game parameters
+- Persistent settings storage
+
+### 📱 **Cross-Platform**
+- iOS and Android support
+- Consistent performance across devices
+- Responsive design for different screen sizes
+
+### 🎮 **Game Features**
+- **Physics Simulation**: Realistic movement and collisions
+- **Particle Systems**: Visual effects and animations
+- **Procedural Generation**: Dynamic content (mazes, obstacles)
+- **Score Systems**: Leaderboards and achievements
+- **Progressive Difficulty**: Adaptive challenge levels
+
+## 📄 License
+
+This library is available under a **dual licensing model**:
+
+### 🆓 **Non-Commercial License (Free)**
+- ✅ **Personal projects** and learning
+- ✅ **Educational use** and research
+- ✅ **Open source projects** (non-commercial)
+- ✅ **Portfolio** and demonstration apps
+
+### 💼 **Commercial License (Paid)**
+Required for commercial use including:
+- 🏢 **Commercial applications** and products
+- 💰 **Revenue-generating** projects
+- 🏪 **App Store** or **Play Store** apps with monetization
+- 🏭 **Enterprise** and business applications
+
+**Commercial licensing includes:**
+- Full commercial usage rights
+- Priority support and maintenance
+- Custom feature development consideration
+- Optional attribution removal
+
+**Get Commercial License:**
+📧 Email: [niranjan.devasani@gmail.com](mailto:niranjan.devasani@gmail.com?subject=React%20Native%20Games%20-%20Commercial%20License%20Request)
+
+See the complete [LICENSE](LICENSE) file for detailed terms and definitions.
+
+## 🙏 Acknowledgments
+
+- Built with [React Native Skia](https://shopify.github.io/react-native-skia/) for high-performance graphics
+- Powered by [React Native Reanimated](https://docs.swmansion.com/react-native-reanimated/) for smooth animations
+- State management with [Zustand](https://github.com/pmndrs/zustand)
+- Created with [create-react-native-library](https://github.com/callstack/react-native-builder-bob)
+
+## 📞 Support
+
+- 📧 **Email**: niranjan.devasani@gmail.com
+- 🐛 **Issues**: [GitHub Issues](https://github.com/ursnj/react-native-games/issues)
+- 💬 **Discussions**: [GitHub Discussions](https://github.com/ursnj/react-native-games/discussions)
+
+---
+
+**Made with ❤️ by [Niranjan Devasani](https://github.com/ursnj)**