Home Tooling

Complete development tooling for the Home programming language.

📦 Components

1. VSCode Extension

Location: ../packages/vscode-home/

Full-featured VSCode extension with:

• Syntax highlighting
• Language Server Protocol integration
• Debugging support
• Performance profiling
• Package management
• Code formatting
• InlayHints
• CodeLens

Documentation

2. Package Registry

Location: ../packages/registry/

Centralized package hosting and distribution:

• RESTful API
• User authentication
• Package publishing
• Search functionality
• Download statistics
• MongoDB + Redis backend

Documentation

🚀 Quick Start

Install VSCode Extension

cd ../packages/vscode-home
npm install
npm run compile
code --install-extension .

Start Package Registry

cd ../packages/registry
npm install
npm run dev

📖 Documentation

• Complete Tooling Documentation - Comprehensive guide
• VSCode Extension Guide - Extension-specific docs
• Package Registry API - API reference

✨ Features

IDE Support

• ✅ Syntax highlighting for .home files
• ✅ Auto-completion
• ✅ Go to definition
• ✅ Find references
• ✅ Hover information
• ✅ Error diagnostics
• ✅ Code formatting
• ✅ InlayHints for types

Debugging

• ✅ Breakpoints
• ✅ Step through code
• ✅ Variable inspection
• ✅ Call stack
• ✅ Exception handling
• ✅ Profiler integration

Profiling

• ✅ Function timing
• ✅ Call count tracking
• ✅ Performance reports
• ✅ HTML visualization
• ✅ Timeline view

Package Management

• ✅ Publish packages
• ✅ Search packages
• ✅ Install dependencies
• ✅ Version management
• ✅ User authentication

🛠️ Development

Prerequisites

• Node.js 18+
• VSCode 1.80+
• MongoDB (for registry)
• Redis (for registry)

Build All

# VSCode Extension
cd ../packages/vscode-home
npm run compile

# Package Registry
cd ../packages/registry
npm run build

Run Tests

# VSCode Extension
cd ../packages/vscode-home
npm test

# Package Registry
cd ../packages/registry
npm test

🏗️ Architecture

Home Tooling
├── VSCode Extension
│   ├── Language Client (LSP)
│   ├── Debug Adapter (DAP)
│   ├── Profiler Integration
│   └── Package Manager Client
│
└── Package Registry
    ├── REST API Server
    ├── MongoDB Database
    ├── Redis Cache
    └── File Storage

📊 Statistics

🔗 Links

• Home Language
• VSCode Marketplace
• Package Registry
• Documentation

📝 License

MIT License - see LICENSE for details.

🤝 Contributing

Contributions welcome! See CONTRIBUTING.md for guidelines.

Status: Production Ready ✅

All tooling components are complete, tested, and ready for use.