Update README with comprehensive documentation from docs directory

[Copilot]

This PR addresses the issue by consolidating all documentation from the Docs/DeepLevel.docc/ directory into the main README.md file, transforming it from a minimal 2-line description into a comprehensive 447-line documentation resource.

Changes Made

The updated README now includes all content from the documentation files:

• Project Overview - Complete description of DeepLevel as a sophisticated dungeon generation system with three distinct algorithms
• Getting Started Guide - Step-by-step integration instructions with Swift code examples for dungeon creation, SpriteKit rendering, and field-of-view calculations
• Algorithm Documentation - Detailed explanations of all three generation algorithms (Room-and-Corridor, BSP, Cellular Automata) with characteristics, use cases, and configuration examples
• Architecture Guide - Comprehensive system design documentation including component interactions, data flow, performance optimizations, and extension points
• API Reference - Complete listing of all classes, protocols, and core types with categorization
• Practical Information - Controls, configuration options, extension ideas, and technical notes

Documentation Sources Consolidated

• Docs/DeepLevel.docc/DeepLevel.md - Main API reference and project overview
• Docs/DeepLevel.docc/Getting-Started.md - Integration guide and usage examples
• Docs/DeepLevel.docc/Game-Architecture.md - System architecture and design patterns
• Docs/DeepLevel.docc/Dungeon-Algorithms.md - Algorithm explanations and comparisons
• DeepLevel/README.md - Implementation details, controls, and configuration

Result

The README now serves as a single, comprehensive documentation source that includes:

• 61 properly structured headers
• 9 Swift code examples with syntax highlighting
• Algorithm comparison table
• Architecture diagrams in ASCII art
• Complete configuration reference

This change makes the project documentation much more accessible to developers by providing all essential information in the main README file, eliminating the need to navigate through multiple documentation files to understand the project's capabilities and usage.

---

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.