# williamsmithedward/xlide_vscode architecture

> Architecture diagram of the GitHub repository williamsmithedward/xlide_vscode, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-05). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/williamsmithedward/xlide_vscode
- Repository: https://github.com/williamsmithedward/xlide_vscode

## Overview

XLIDE is a VS Code extension for editing Office VBA and VB6 projects directly, without requiring COM for ordinary container access. Users open a macro-enabled file, browse and edit its modules with host-aware language services, analyze or refactor code, and save changes back to the container; optional workflows synchronize text files, design forms and shapes, and run VBA tests through an Office host. The README documents these capabilities; sampled source supports the parser/analyzer and container-engine links shown below, while some feature wiring remains unsampled.

Main entry points: [`src/vbaLanguageProviders.ts`](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaLanguageProviders.ts) (Editor language features), [`src/projectEngine.ts`](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/projectEngine.ts) (Project engine), [`src/projectExplorer.ts`](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/projectExplorer.ts) (Project explorer), [`src/analyzer/parser/parseModule.ts`](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/parser/parseModule.ts) (Module parser)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace and projects"]
  node_project["Project explorer<br/>[projectExplorer.ts]"]
  node_projectengine["Project engine<br/>[projectEngine.ts]"]
  node_workspacefiles["Workspace files<br/>[xlideFileSystem.ts]"]
end

subgraph group_language["VBA language services"]
  node_source["VBA source scan<br/>[vbaSourceScan.ts]"]
  node_lexer["Lexer<br/>[tokenize.ts]"]
  node_parser["Module parser<br/>[parseModule.ts]"]
  node_symbols["Project symbols<br/>[projectIndex.ts]"]
  node_hostmodel["Host object models<br/>[hostModel.ts]"]
  node_completion["IntelliSense<br/>[memberAccess.ts]"]
  node_analysis["Static analysis<br/>[analyzeModule.ts]"]
  node_providers["Editor language features"]
end

subgraph group_containers["Container editing"]
  node_containersvc["Container operations<br/>[projectService.ts]"]
  node_formdesigner["Form designer<br/>[formDesigner.ts]"]
  node_shapeeditor["Shape editor<br/>[shapeEditor.ts]"]
  node_sync["Module sync<br/>[moduleSyncPlan.ts]"]
end

subgraph group_engineering["Engineering tools"]
  node_refactor["Refactorings"]
  node_tests["VBA test runner"]
  node_agenttools["Agent tools<br/>[agentTools.ts]"]
end

subgraph group_integrations["Optional integrations"]
  node_office["Office host"]
  node_ai(("AI assistant"))
end

node_developer(("Developer"))
node_vscode["VS Code"]

node_developer -->|"edits in"| node_vscode
node_vscode -->|"opens projects"| node_project
node_project -.->|"reads project"| node_projectengine
node_projectengine -->|"dispatches operations"| node_containersvc
node_containersvc -.->|"reads and writes"| node_workspacefiles
node_project -->|"scans VBA"| node_source
node_vscode -->|"requests language features"| node_providers
node_providers -.->|"parses modules"| node_parser
node_parser -->|"tokenizes source"| node_lexer
node_parser -.->|"builds symbols"| node_symbols
node_providers -->|"provides completion"| node_completion
node_completion -->|"looks up host members"| node_hostmodel
node_providers -->|"reports diagnostics"| node_analysis
node_analysis -.->|"checks host members"| node_hostmodel
node_analysis -.->|"uses project symbols"| node_symbols
node_developer -->|"requests refactoring"| node_refactor
node_developer -->|"edits forms"| node_formdesigner
node_formdesigner -->|"updates form storage"| node_containersvc
node_developer -->|"edits shapes"| node_shapeeditor
node_shapeeditor -.->|"writes shape changes"| node_projectengine
node_developer -->|"previews module sync"| node_sync
node_sync -->|"imports and exports"| node_workspacefiles
node_developer -->|"runs VBA tests"| node_tests
node_tests -->|"executes tests"| node_office
node_ai -->|"uses XLIDE tools"| node_agenttools
node_agenttools -.->|"accesses project"| node_projectengine

click node_project "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/projectExplorer.ts"
click node_projectengine "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/projectEngine.ts"
click node_workspacefiles "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/xlideFileSystem.ts"
click node_source "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaSourceScan.ts"
click node_lexer "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/lexer/tokenize.ts"
click node_parser "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/parser/parseModule.ts"
click node_symbols "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/symbols/projectIndex.ts"
click node_hostmodel "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/host/hostModel.ts"
click node_completion "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/completion/memberAccess.ts"
click node_analysis "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/diagnostics/analyzeModule.ts"
click node_providers "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaLanguageProviders.ts"
click node_containersvc "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vba/projectService.ts"
click node_formdesigner "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vba/formDesigner.ts"
click node_shapeeditor "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/shapeEditor.ts"
click node_sync "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/moduleSyncPlan.ts"
click node_refactor "https://github.com/williamsmithedward/xlide_vscode/tree/main/src/analyzer/refactor"
click node_tests "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaTestRunPipeline.ts"
click node_agenttools "https://github.com/williamsmithedward/xlide_vscode/blob/main/src/agentTools.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_project,node_projectengine,node_workspacefiles toneBlue
class node_source,node_lexer,node_parser,node_symbols,node_hostmodel,node_completion,node_analysis,node_providers toneAmber
class node_containersvc,node_formdesigner,node_shapeeditor,node_sync toneMint
class node_refactor,node_tests,node_agenttools toneRose
class node_office,node_ai,node_developer,node_vscode toneIndigo
```

## Components

### Workspace and projects

- [Project explorer](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/projectExplorer.ts): `src/projectExplorer.ts`
- [Project engine](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/projectEngine.ts): `src/projectEngine.ts`
- [Workspace files](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/xlideFileSystem.ts): `src/xlideFileSystem.ts`

### VBA language services

- [VBA source scan](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaSourceScan.ts): `src/vbaSourceScan.ts`
- [Lexer](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/lexer/tokenize.ts): `src/analyzer/lexer/tokenize.ts`
- [Module parser](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/parser/parseModule.ts): `src/analyzer/parser/parseModule.ts`
- [Project symbols](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/symbols/projectIndex.ts): `src/analyzer/symbols/projectIndex.ts`
- [Host object models](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/host/hostModel.ts): `src/analyzer/host/hostModel.ts`
- [IntelliSense](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/completion/memberAccess.ts): `src/analyzer/completion/memberAccess.ts`
- [Static analysis](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/analyzer/diagnostics/analyzeModule.ts): `src/analyzer/diagnostics/analyzeModule.ts`
- [Editor language features](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaLanguageProviders.ts): `src/vbaLanguageProviders.ts`

### Container editing

- [Container operations](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vba/projectService.ts): `src/vba/projectService.ts`
- [Form designer](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vba/formDesigner.ts): `src/vba/formDesigner.ts`
- [Shape editor](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/shapeEditor.ts): `src/shapeEditor.ts`
- [Module sync](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/moduleSyncPlan.ts): `src/moduleSyncPlan.ts`

### Engineering tools

- [Refactorings](https://github.com/williamsmithedward/xlide_vscode/tree/main/src/analyzer/refactor): `src/analyzer/refactor`
- [VBA test runner](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/vbaTestRunPipeline.ts): `src/vbaTestRunPipeline.ts`
- [Agent tools](https://github.com/williamsmithedward/xlide_vscode/blob/main/src/agentTools.ts): `src/agentTools.ts`

### Optional integrations

- **Office host**
- **AI assistant**

### Other components

- **Developer**
- **VS Code**

## Connections

- Developer → VS Code: edits in
- VS Code → Project explorer: opens projects
- Project explorer → Project engine: reads project
- Project engine → Container operations: dispatches operations (evidence: `src/projectEngine.ts`)
- Container operations → Workspace files: reads and writes
- Project explorer → VBA source scan: scans VBA (evidence: `src/commands/projectCrudCommands.ts`)
- VS Code → Editor language features: requests language features
- Editor language features → Module parser: parses modules
- Module parser → Lexer: tokenizes source (evidence: `src/analyzer/parser/parseModule.ts`)
- Module parser → Project symbols: builds symbols
- Editor language features → IntelliSense: provides completion
- IntelliSense → Host object models: looks up host members (evidence: `src/analyzer/completion/memberAccess.ts`)
- Editor language features → Static analysis: reports diagnostics
- Static analysis → Host object models: checks host members
- Static analysis → Project symbols: uses project symbols
- Developer → Refactorings: requests refactoring
- Developer → Form designer: edits forms
- Form designer → Container operations: updates form storage (evidence: `src/vba/projectService.ts`)
- Developer → Shape editor: edits shapes
- Shape editor → Project engine: writes shape changes
- Developer → Module sync: previews module sync
- Module sync → Workspace files: imports and exports
- Developer → VBA test runner: runs VBA tests
- VBA test runner → Office host: executes tests
- AI assistant → Agent tools: uses XLIDE tools
- Agent tools → Project engine: accesses project
