# auto-vscode

**Repository Path**: auto-stack/auto-vscode

## Basic Information

- **Project Name**: auto-vscode
- **Description**: Auto语言的vscode插件
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2024-10-31
- **Last Updated**: 2026-01-15

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Auto VSCode

VSCode的Auto语言插件。

## Features (v0.2.0)

### ✅ Language Server Protocol (LSP) Support
- **Enhanced Code Completion**
  - Context-aware completion for types, functions, variables, and members
  - User-defined types and functions extracted from AST
  - Trigger character support for `.` (member access)
  - Scope-aware type inference for local variables inside functions
  - Member completions show fields and methods for custom types

- **Hover Information**
  - Hover over keywords shows usage documentation with examples
  - Hover over types shows type descriptions
  - Hover over stdlib functions shows signatures and examples
  - Hover over user-defined types, functions, methods, and fields
  - Scope-aware hover for local variables inside function scopes

- **Go to Definition**
  - Navigate to function definitions (F12 or Ctrl+Click)
  - Navigate to type definitions
  - Navigate to variable declarations
  - Navigate to type methods and fields
  - Symbol map built from parsed AST with precise locations

- **Diagnostics**
  - Real-time error checking as you type
  - Syntax errors appear in red squigglies
  - Error messages show in Problems panel
  - Line-based error location with timeout protection

### ✅ Syntax Highlighting
- AutoLang syntax highlighting for `.at`, `.as`, `.ac` files
- TextMate grammar for comprehensive token coverage

## Installation

### From Visual Studio Marketplace (Recommended)
1. Open VSCode
2. Press `Ctrl+Shift+X` to open Extensions
3. Search for "Auto Lang"
4. Click Install

### Manual Installation
1. Download the latest `.vsix` file from [Releases](https://github.com/auto-stack/auto-vscode/releases)
2. In VSCode:
   - Press `Ctrl+Shift+P`
   - Type "Install from VSIX"
   - Select the downloaded `.vsix` file

## Development

See [README-LSP.md](README-LSP.md) for LSP development and testing instructions.

## Quick Start

1. Create a new file called `test.at`
2. Start typing AutoLang code:
   ```auto
   type Point {
       x int
       y int

       fn square() int {
           x * x + y * y
       }
   }

   fn main() {
       let p Point = Point { x: 3, y: 4 }
       p.  // Type dot to see completions for x, y, square
   }
   ```

3. Try these features:
   - **Hover**: Hover over `Point`, `square`, or `p` to see documentation
   - **Go to Definition**: Press F12 on `square` to jump to its definition
   - **Completion**: Type `p.` to see available fields and methods
   - **Diagnostics**: Type invalid syntax to see error highlighting

## Version History

See [CHANGELOG.md](vscode-extension/CHANGELOG.md) for detailed version history.

### v0.2.0 (2025-01-15)
- Added enhanced code completion with scope-aware type inference
- Added hover information for all symbols
- Added go-to-definition navigation
- Added real-time diagnostics
- Fixed critical document synchronization bug

### v0.1.0 (2025-01-14)
- Initial LSP implementation with basic code completion

### v0.0.3
- Initial syntax highlighting support

## License

MIT

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.