HSM Extension for Visual Studio Code

Note: This is an early prototype written in a couple of hours. While functional, it's not yet optimized for large codebases.

This extension enhances the development experience when working with the Hierarchical State Machine (HSM) library for Go. It provides features to navigate between state definitions and their references in source and target declarations.

Features

• State Navigation: Clickable links on state paths that navigate to their definitions
• State Validation: Error diagnostics for state paths that don't exist in the model
• Intelligent Auto-completion: Context-aware suggestions for state paths within Target/Source declarations
• Hierarchical State Support: Full support for nested state hierarchies with qualified path names

Requirements

• Visual Studio Code 1.70.0 or newer
• Go extension for VS Code installed and configured
• Go 1.18 or newer

Installation

1. Install the Go extension for VS Code
2. Install this extension
3. Open a workspace containing HSM Go code

Usage

The extension automatically activates when editing Go files and provides:

• Auto-completion: When typing state paths in Target/Source declarations, get context-aware suggestions
• Navigation: Click on state paths to jump to their definitions
• Validation: See error diagnostics for invalid state path references
• Hierarchical Support: Full support for absolute and relative state paths

Technical Details

The extension uses Tree-sitter for precise Go code parsing and analysis, providing:

• Accurate state definition detection
• Context-aware path resolution for nested states
• Real-time validation and diagnostics
• Intelligent completion suggestions based on the current model context

Contributing

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

License

This extension is licensed under the MIT License.