Viper_VSCode/architecture/generated/subsystems/languageservice.md

Subsystem: languageService

Source files under languageService/. Grouped by the functional area each file was assigned to during semantic lifting.

• Files: 23
• Symbols (leaves): 300

Language Service Providers

• languageService/analyzerServiceExecutor.ts — Runs and clones AnalyzerService and builds command-line options from server settings
• languageService/autoImporter.ts — Provides auto-import completion logic and utilities for finding module symbols and generating import edits
• languageService/callHierarchyProvider.ts — Provides call hierarchy items (callers and callees) for a code position across the workspace
• languageService/codeActionProvider.ts — Provides quick-fix code actions for diagnostics, including a create-type-stub action
• languageService/completionProvider.ts — Provides Python language completion items for a source position using type and symbol analysis
• languageService/completionProviderUtils.ts — Helper utilities for completion items: type details, formatted documentation, and trailing overlap detection
• languageService/definitionProvider.ts — Maps positions to symbol and type declarations for go-to-definition and type-definition features
• languageService/documentHighlightProvider.ts — Provides document highlights for a name at a given position, classifying occurrences as read or write
• languageService/documentSymbolCollector.ts — Collects and resolves symbol declarations and references within a parse tree for document-level symbol occurrences
• languageService/documentSymbolProvider.ts — Provides document symbol extraction and conversion to hierarchical or flat LSP SymbolInformation for a source file
• languageService/dynamicFeature.ts — Manages dynamic LSP features with register/update/dispose logic and a registry for multiple features
• languageService/fileWatcherDynamicFeature.ts — Registers LSP file-watcher notifications for workspace config files and Python search paths
• languageService/hoverProvider.ts — Generates editor hover tooltips for Python symbols with type info, signatures, and documentation
• languageService/importSorter.ts — Sorts and formats top-level Python import statements and produces TextEditAction replacements
• languageService/navigationUtils.ts — Provides helpers to check file navigability and convert DocumentRange objects to LSP Location values
• languageService/pullDiagnosticsDynamicFeature.ts — Registers and manages pull-mode diagnostics and workspace support with the language server
• languageService/quickActions.ts — Provides quick action handlers for source files such as ordering imports
• languageService/referencesProvider.ts — Finds symbol references in files and returns DocumentRange/LSP locations
• languageService/renameProvider.ts — Provides rename support: checks rename eligibility and produces workspace edits for a symbol and its references
• languageService/signatureHelpProvider.ts — Provides signature help for Python call sites by mapping a cursor position to callable signatures and parameter info
• languageService/symbolIndexer.ts — Indexes all externally visible symbols and aliases in a source file into structured metadata
• languageService/tooltipUtils.ts — Formats and generates hover/completion tooltips and documentation text for types, functions, classes, and symbols
• languageService/workspaceSymbolProvider.ts — Provides workspace symbol search for the language server across user code

Cross-subsystem dependencies

Imported by (external):

• commands/createTypeStub.ts
• commands/quickActionCommand.ts
• src/languageServerBase.ts
• src/server.ts

Imports (external):

• analyzer/analyzerFileInfo.ts
• analyzer/analyzerNodeInfo.ts
• analyzer/constructors.ts
• analyzer/declaration.ts
• analyzer/declarationUtils.ts
• analyzer/enums.ts
• analyzer/importResolver.ts
• analyzer/importResult.ts
• analyzer/importStatementUtils.ts
• analyzer/parameterUtils.ts
• analyzer/parseTreeUtils.ts
• analyzer/parseTreeWalker.ts
• analyzer/pythonPathUtils.ts
• analyzer/scope.ts
• analyzer/scopeUtils.ts
• analyzer/service.ts
• analyzer/sourceFile.ts
• analyzer/sourceFileInfoUtils.ts
• analyzer/sourceMapper.ts
• analyzer/symbol.ts
• analyzer/symbolNameUtils.ts
• analyzer/symbolUtils.ts
• analyzer/typeDocStringUtils.ts
• analyzer/typeEvaluatorTypes.ts
• analyzer/typePrinter.ts
• analyzer/typeUtils.ts
• analyzer/typedDicts.ts
• analyzer/types.ts
• commands/commands.ts
• common/cancellationUtils.ts
• common/collectionUtils.ts
• common/commandLineOptions.ts
• common/commandUtils.ts
• common/configOptions.ts
• common/console.ts
• common/core.ts
• common/debug.ts
• common/diagnostic.ts
• common/docRange.ts
• common/docStringService.ts
• common/editAction.ts
• common/extensibility.ts
• common/fileSystem.ts
• common/languageServerInterface.ts
• common/lspUtils.ts
• common/pathConsts.ts
• common/pathUtils.ts
• common/positionUtils.ts
• common/pythonVersion.ts
• common/serviceKeys.ts
• common/serviceProvider.ts
• common/serviceProviderExtensions.ts
• common/stringUtils.ts
• common/textRange.ts
• common/textRangeCollection.ts
• uri/emptyUri.ts
• uri/uri.ts
• uri/uriUtils.ts
• common/workspaceEditUtils.ts
• localization/localize.ts
• parser/parseNodes.ts
• parser/parser.ts
• parser/tokenizer.ts
• parser/tokenizerTypes.ts
• src/workspaceFactory.ts