How eclipse-langium/langium works
Main Components (Core Architecture)
a) Core Language Processing Layer:
• Grammar Processing (packages/langium/src/grammar)
• Parser System (packages/langium/src/parser)
• AST Management (packages/langium/src/syntax-tree.ts)
• Type System (packages/langium/src/grammar/type-system)
b) Language Server Protocol (LSP) Layer:
• LSP Services (packages/langium/src/lsp)
• Document Management (packages/langium/src/workspace)
• Validation System (packages/langium/src/validation)
c) Generation & Tools:
• Code Generator (packages/langium/src/generate)
• CLI Tools (packages/langium-cli)
• VS Code Integration (packages/langium-vscode)
Component Relationships
• Grammar → Parser (Grammar definitions feed into parser generation)
• Parser → AST (Parser produces Abstract Syntax Trees)
• AST → LSP Services (AST provides basis for language services)
• LSP Services → IDE Integration (Services connect to IDE features)
Architectural Patterns to Highlight
a) Service Layer Pattern:
• Dependency injection system
• Service registry connections
• Module system organization
b) Pipeline Pattern:
• Text Input → Lexer → Parser → AST → Validation → IDE Services
Integration Points
External integration points:
• VS Code Extension Host
• Language Server Protocol
• Web Browser Runtime
• CLI Environment
• Source Text → Tokenization → Parsing → AST Building → Validation → IDE Features
Implementation Details
Technical details in notes:
• Built on TypeScript
• Uses Chevrotain for parsing
• LSP protocol implementation
• Web/Node.js runtime support