AWD-M2-Edit/extension

ADW Modula-2 Language Server (LSP)

A high-performance implementation of the Language Server Protocol for the ADW Modula-2 dialect, featuring full support for Object-Oriented extensions including CLASS, INHERIT, and OVERRIDE.

Core Functionality

1. Semantic Analysis

• Contextual Highlighting: Distinguished rendering for Types, Constants, Variables, and Procedures.
• Comment Handling: Robust parsing of nested comments (* (* ... *) *) and complex strings to prevent highlighting bleed.

2. Navigation Logic

• Go to Definition: Resolution of local symbols and cross-file navigation to .def headers.
• Go to Implementation: Direct mapping from procedure signatures in .def files to the corresponding bodies in .mod files.
• Symbol Lookup: Comprehensive workspace-wide symbol indexing and search.

3. ADW OOP Support

• Inheritance Mapping: Resolution of INHERIT chains to provide accurate member completion for base classes.
• Override Identification: Explicit marking of OVERRIDE methods within the Document Outline.

4. Technical Architecture

• Indentation-Aware Scoping: Deterministic scope resolution for nested procedures and modules based on block indentation.
• Asynchronous Indexing: Background processing of all workspace .def and .mod files for non-blocking cross-reference resolution.

Installation

VSIX Package

1. Obtain the adw-modula2-lsp.vsix file.
2. In VS Code, navigate to the Extensions view (Ctrl+Shift+X).
3. Select Install from VSIX... from the local menu and select the file.

Source Build

1. Clone the repository.
2. Execute npm install in the root, /client, and /server directories.
3. Execute npm run compile.
4. Launch the Extension Development Host via F5.

Project Structure

• client/: VS Code extension client-side activation and lifecycle management.
• server/: LSP Server implementation containing the Modula-2 parser and symbol engine.
• logo.png: Extension identifier icon.

License

This project is licensed under the MIT License. See the LICENSE file for full text.

Automatic keyword uppercasing

Version 0.1.1 automatically uppercases Modula-2 keywords as you edit .mod and .def files. Comments, pragmas, strings, character literals and longer identifiers are protected.

The feature can be disabled with adwModula2.autoUppercaseKeywords, or invoked manually with Modula-2: Uppercase Keywords.

Snippets

The extension provides Modula-2 snippets for modules, definition/implementation modules, procedures, control flow, declarations, imports, records, pointers, and sets. Snippets are available for both .mod and .def files.

Common prefixes include module, definition, implementation, proc, if, ifelse, for, while, repeat, loop, case, record, type, var, const, from, and import.