How daltskin/sysml-v2-lsp works
SysML v2 Language Server parses editor documents, builds workspace symbols, and serves LSP features to VS Code, web, and Python clients. The principal flow is client requests → server/document lifecycle → parsing and symbol indexing → language features or model results. Separate branches cover standard-library resolution, semantic validation, complexity analysis, Mermaid diagrams, and MCP tools. README documents these capabilities; some implementation connections are not shown in the excerpts, so those links are omitted or marked unverified.
Main entry points: server.ts LSP Server · semanticValidator.ts Semantic Validation · sysmlModelProvider.ts Model Provider · symbolTable.ts Symbol Table
Components 22
Clients
- VS Code
clients/vscode/src/extension.ts - Web Client
clients/web/server.mjs - Python Client
clients/python/sysml_lsp_client.py
Server Runtime
- LSP Server
server/src/server.ts - Document Manager
server/src/documentManager.ts
Language Model
- SysML Parser
server/src/parser/parseDocument.ts - DFA Loader
server/src/parser/dfaLoader.ts - DFA Snapshot
server/src/parser/dfaSnapshot.ts - Symbol Table
server/src/symbols/symbolTable.ts - Element Registry
server/src/symbols/elementRegistry.ts - Namespace Resolver
server/src/symbols/namespaceResolver.ts - SysML Elements
server/src/symbols/sysmlElements.ts - Library Index
server/src/library/libraryIndex.ts
Language Features
- Editor Providers
server/src/providers - Semantic Validation
server/src/providers/semanticValidator.ts - Text Validation
server/src/providers/textValidationProvider.ts - Model Provider
server/src/model/sysmlModelProvider.ts - Model DTOs
server/src/model/sysmlModelTypes.ts - Element Lookup
server/src/model/elementLookupProvider.ts
Analysis and Tools
- Complexity Analysis
server/src/analysis/complexityAnalyzer.ts - Mermaid Generator
server/src/mcp/mermaidGenerator.ts - MCP Tools
server/src/mcpCore.ts
Connections 22
- VS Code → LSP Server: sends LSP
- Web Client → LSP Server: bridges LSP
- Python Client → LSP Server: sends LSP
- LSP Server → Document Manager: manages documents
server/src/server.ts - Document Manager → SysML Parser: parses text
server/src/documentManager.ts - SysML Parser → DFA Loader: uses DFA
server/src/parser/parseDocument.ts - DFA Loader → DFA Snapshot: loads snapshot
server/src/parser/dfaLoader.ts - Symbol Table → SysML Parser: reads parse tree
server/src/symbols/symbolTable.ts - Symbol Table → Element Registry: updates registry
server/src/symbols/symbolTable.ts - Namespace Resolver → Element Registry: resolves elements
server/src/symbols/namespaceResolver.ts - LSP Server → Editor Providers: registers providers
server/src/server.ts - LSP Server → Semantic Validation: registers provider
server/src/server.ts - LSP Server → Text Validation: configures provider
server/src/server.ts - LSP Server → Model Provider: serves model requests
server/src/server.ts - Model Provider → Document Manager: reuses parse cache
server/src/model/sysmlModelProvider.ts - Model Provider → Model DTOs: produces DTOs
server/src/model/sysmlModelProvider.ts - LSP Server → Element Lookup: registers lookup
server/src/server.ts - Semantic Validation → Library Index: resolves library types
server/src/providers/semanticValidator.ts - Semantic Validation → Namespace Resolver: resolves names
server/src/providers/semanticValidator.ts - Semantic Validation → Symbol Table: checks symbols
server/src/providers/semanticValidator.ts - Model Provider → Complexity Analysis: uses analysis
server/src/model/sysmlModelProvider.ts - MCP Tools → Mermaid Generator: may generate diagrams