Merge branch 'main' of https://github.com/georgeantonopoulos/singularity into gh-pages

Author: georgeantonopoulos

.gitignore

@@ -30,4 +30,6 @@ Thumbs.db
 .env.production.local
 
 # Vite
-.vite/ 
+.vite/ 
+
+.cursorrules

3D_CAMERA_NOTES.md

@@ -0,0 +1,36 @@
+# 3D Camera Conversion Plan
+
+## Overview
+This branch is dedicated to converting the game from an orthographic camera (2D view) to a perspective camera (3D view) while maintaining the same game dynamics and gameplay.
+
+## Current Implementation
+- The game currently uses an orthographic camera in Three.js
+- The camera is positioned at z=80 looking at the origin (0,0,0)
+- The frustum size is 60 units
+- The game area is defined by:
+  - gameWidth = 100
+  - gameHeight = 60
+
+## Conversion Strategy
+1. **Analysis Phase** (Current)
+   - Understanding the current camera implementation
+   - Identifying all code sections that depend on the orthographic camera
+   - Analyzing game dynamics that might be affected by the perspective camera
+
+2. **Development Phase** (Upcoming)
+   - Replace OrthographicCamera with PerspectiveCamera
+   - Adjust field of view, near and far planes
+   - Modify camera position and controls to maintain similar view
+   - Update all screen-to-world and world-to-screen coordinate conversions
+   - Adapt UI elements to work with perspective projection
+
+3. **Testing Phase** (Upcoming)
+   - Test gameplay dynamics to ensure they remain unchanged
+   - Verify that object interactions remain consistent
+   - Fine-tune camera parameters for optimal experience
+
+## Key Considerations
+- The lens distortion effect around the black hole might need adjustments
+- Mouse input handling will need updates for proper world space mapping
+- Game boundaries and object spawning will need recalibration
+- Camera animations and zoom effects will need to be reimplemented 

LICENSE

@@ -0,0 +1,30 @@
+Copyright (c) 2025 George Antonopoulos - Christopher's Singularity & Gravitational Lensing Simulation
+
+All rights reserved.
+
+This software and associated documentation files (the "Software") are protected by copyright law. 
+The following restrictions apply:
+
+1. No part of this Software may be copied, modified, merged, published, distributed, 
+   sublicensed, and/or sold without explicit written permission from George Antonopoulos.
+
+2. The gravitational lensing effect implementation and black hole visualization techniques 
+   are proprietary and may not be reproduced or adapted in any form without explicit 
+   written permission.
+
+3. Viewing and running the Software for personal, non-commercial use is permitted, 
+   provided that:
+   a) No modifications are made to the Software
+   b) All copyright notices and this permission notice are preserved
+   c) Credit is given to George Antonopoulos for any public demonstrations or discussions
+
+4. Commercial use, modification, or redistribution of this Software or any of its 
+   components requires explicit written permission from the copyright holder.
+
+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. 

README.md

@@ -10,6 +10,13 @@ Created by my son Christopher (6) who is really interested in black holes!
 - Beautiful cosmic visuals with stars, nebulae, and distortion effects
 - Grow your black hole by consuming celestial objects
 
+## Development Branches
+
+- **main**: Current stable version with orthographic camera (2D view)
+- **3D_cam**: Development branch for converting to a 3D perspective camera while maintaining gameplay
+
+For details on the 3D camera conversion approach, see the [3D_CAMERA_NOTES.md](3D_CAMERA_NOTES.md) file.
+
 ## Installation
 
 ### Local Development