Copilot instructions

1---
2description: VS Code source code organization — layers, target environments, dependency injection, and folder structure conventions. Reference when adding new modules, services, or contributions.
3applyTo: src/vs/**
4---
5 
6# Source Code Organization
7 
8Canonical reference: https://github.com/microsoft/vscode/wiki/Source-Code-Organization
9 
10## Layers
11 
12The `src/vs/` core is partitioned into ordered layers — each may only import from layers below it:
13 
141. **`base`** — General utilities and UI building blocks (no service dependencies)
152. **`platform`** — Service injection support and base services shared across layers
163. **`editor`** — Monaco Editor core (no `node` or `electron-*` dependencies)
174. **`workbench`** — Full VS Code workbench, panels, views, and framework
185. **`code`** — Desktop app entry point (Electron main, shared process, CLI)
196. **`server`** — Server app entry point for remote development
207. **`sessions`** — Agent Sessions window (may import from `workbench` and below; `workbench` must never import from `sessions`)
21 
22## Target Environments
23 
24Within each layer, code is organized by runtime environment:
25 
26| Folder | APIs Available | May Use |
27|--------|---------------|---------|
28| `common` | Basic JavaScript only | — |
29| `browser` | Web/DOM APIs | `common` |
30| `node` | Node.js APIs | `common` |
31| `electron-browser` | Browser + limited Electron IPC | `common`, `browser` |
32| `electron-utility` | Electron utility process | `common`, `node` |
33| `electron-main` | Electron main process | `common`, `node`, `electron-utility` |
34 
35## Workbench Organization
36 
37- `vs/workbench/{common|browser|electron-browser}` — minimal workbench core
38- `vs/workbench/api` — `vscode.d.ts` API provider
39- `vs/workbench/services` — core services (not contrib-specific)
40- `vs/workbench/contrib` — feature contributions
41 
42### Contribution Rules
43 
44- No dependency from outside `contrib/` into `contrib/`
45- Each contribution has a single `.contribution.ts` entry point
46- Contributions expose internal API from a single common file
47- Cross-contribution dependencies use that common API — never reach into internals
48 
49## Entry Points
50 
51Only code referenced from entry point files is loaded:
52 
53- `workbench.common.main.ts` — shared dependencies
54- `workbench.desktop.main.ts` — desktop-only
55- `workbench.web.main.ts` — web-only
56 
57## Dependency Injection
58 
59Services are consumed via constructor injection with decorator identifiers:
60 
61```typescript
62class MyComponent {
63  constructor(@IMyService private readonly myService: IMyService) { }
64}
65```
66 
67Services are provided via `registerSingleton(IMyService, MyServiceImpl, InstantiationType.Delayed)`.
68