💠 RECURSION X-RAY 💠

Visualize the Invisible. Master the Recursion.

---

🌌 The Next Generation of Algorithm Visualization 🌌

Step into the Cyber-Void. Watch your code come to life in 3D.

LAUNCH HOLODECK (LIVE DEMO) • REPORT BUG • REQUEST FEATURE

🚀 Mission Briefing

Recursion X-Ray is not just another visualizer. It is an immersive research tool designed to peel back the layers of recursive algorithms. Built with a "Cyber-Space" aesthetic, it transforms abstract stack frames into glowing, interactive 3D elements floating in a starfield.

Whether you are debugging complex backtracking algorithms or teaching the fundamentals of recursion, X-Ray gives you the vision you've been missing.

---

✨ Luxurious Features

🌠 3D Starfield Environment

Immerse yourself in a deep-space environment. The background is a living, breathing starfield that reacts to your presence.

🥞 Holographic Call Stack

Visualize the Call Stack like never before. Stack frames are rendered as semi-transparent glass panels in 3D space, stacking up along the Z-axis.

• Active Frame: Glowing Electric Blue 🔵
• Returning Frame: Emerald Green 🟢
• Popped Frame: Fades into the void ⚫

🌳 Interactive Recursion Tree

A dynamic, auto-balancing 2D tree visualizer that maps out every generic call.

• Zoom & Pan: Explore massive recursion trees with fluid controls.
• Real-Time Limits: Watch the tree grow as the algorithm executes.

📺 Presentation Mode

Maximize your impact. With a single click, hide all UI clutter and expand the visualization to Full Screen. Perfect for lectures, streams, and presentations.

💻 Live C++ Transpiler

Write standard C++ code in the editor. Our custom in-browser transpiler converts it to executable JavaScript on the fly, preserving the recursive structure for visualization.

---

🛠️ Tech Stack

Component	Technology	Description
3D Engine		High-performance WebGL rendering.
Frontend		Modern, semantic, and neon-styled.
Logic		Vanilla ES6+ for maximum performance.
Transpiler	Custom Regex Engine	Transpiles C++ to JS logic in real-time.

---

⚡ Getting Started

1. Clone the Repository

git clone https://github.com/yourusername/recursion-xray.git
cd recursion-xray

2. Launch the System

Simply open index.html in your favorite modern browser. No build steps required.

• Recommended: Use Live Server extension for VS Code for the best experience.

3. Execute Your First Algorithm

1. Select "Factorial" from the drop-down menu.
2. Click ⚡ COMPILE_AND_RUN.
3. Watch the magic happen.

---

🎮 Controls

Command	Action
Left Click + Drag	Rotate the 3D Camera around the stack.
Scroll	Zoom in/out of the 3D view.
Right Click + Drag	Pan the camera.
📺 Button	Toggle Presentation (Full Screen) Mode.

---

Ready to visualize the impossible?

⭐ Star this Repo

Created with ❤️ & ☕ by [Your Name]