# sage-erp-x3/typescript architecture

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

- Interactive diagram: https://gitdiagram.com/sage-erp-x3/typescript
- Repository: https://github.com/sage-erp-x3/typescript

## Overview

TypeScript is a compiler and application-development toolchain. A typical command-line path starts with a developer invoking tsc, parses options and source, builds a program, checks types, transforms and emits JavaScript and declarations. Its other major product branch is the editor language service exposed through tsserver, alongside project/watch and typings support. The graph follows documented or indexed module relationships; some internal stage-to-stage calls and external host details are not shown in the excerpts, so those links are omitted rather than inferred.

Main entry points: [`src/compiler/program.ts`](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/program.ts) (Program Builder), [`src/tsc/tsc.ts`](https://github.com/sage-erp-x3/typescript/blob/master/src/tsc/tsc.ts) (tsc CLI), [`src/server/editorServices.ts`](https://github.com/sage-erp-x3/typescript/blob/master/src/server/editorServices.ts) (Project Services), [`src/services/services.ts`](https://github.com/sage-erp-x3/typescript/blob/master/src/services/services.ts) (Language Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_compiler["Compiler"]
  node_tsc["tsc CLI<br/>[tsc.ts]"]
  node_options["Options Parser"]
  node_parser["Source Parser<br/>[parser.ts]"]
  node_binder["Binder<br/>[binder.ts]"]
  node_checker["Type Checker<br/>[checker.ts]"]
  node_program["Program Builder<br/>[program.ts]"]
  node_transform["Transformers<br/>[transformer.ts]"]
  node_emitter["JavaScript Emitter<br/>[emitter.ts]"]
  node_build["Build Mode<br/>[tsbuild.ts]"]
  node_watch["Watch Mode<br/>[watch.ts]"]
end

subgraph group_editor["Editor Services"]
  node_services["Language Service<br/>[services.ts]"]
  node_classifier["Code Classifier<br/>[classifier.ts]"]
  node_codefix["Code Fixes<br/>[codeFixProvider.ts]"]
end

subgraph group_server["Language Server"]
  node_serverentry["tsserver Entry<br/>[server.ts]"]
  node_session["Protocol Session<br/>[session.ts]"]
  node_project["Project Services<br/>[editorServices.ts]"]
  node_protocol["Server Protocol<br/>[protocol.ts]"]
end

subgraph group_support["Project Support"]
  node_js_typing["JS Typings<br/>[jsTyping.ts]"]
  node_typing_install["Typings Installer"]
  node_standard_libs["Standard Libraries"]
end

node_developer(("Developer"))
node_filesystem[("Host Filesystem")]

node_developer -->|"invokes"| node_tsc
node_tsc -.->|"parses options"| node_options
node_options -.->|"configures build"| node_program
node_program -.->|"parses sources"| node_parser
node_program -.->|"binds symbols"| node_binder
node_program -.->|"checks types"| node_checker
node_program -.->|"transforms sources"| node_transform
node_program -.->|"emits outputs"| node_emitter
node_tsc -.->|"supports builds"| node_build
node_tsc -.->|"supports watch"| node_watch
node_developer -.->|"uses editor"| node_serverentry
node_serverentry -->|"starts session"| node_session
node_session -->|"handles messages"| node_protocol
node_session -.->|"dispatches requests"| node_project
node_project -.->|"provides language features"| node_services
node_services -->|"creates classifier"| node_classifier
node_services -.->|"offers fixes"| node_codefix
node_project -->|"reads config"| node_filesystem
node_project -.->|"uses typing support"| node_js_typing
node_js_typing -.->|"requests typings"| node_typing_install
node_program -.->|"includes libraries"| node_standard_libs

click node_tsc "https://github.com/sage-erp-x3/typescript/blob/master/src/tsc/tsc.ts"
click node_options "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/commandLineParser.ts"
click node_parser "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/parser.ts"
click node_binder "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/binder.ts"
click node_checker "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/checker.ts"
click node_program "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/program.ts"
click node_transform "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/transformer.ts"
click node_emitter "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/emitter.ts"
click node_build "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/tsbuild.ts"
click node_watch "https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/watch.ts"
click node_services "https://github.com/sage-erp-x3/typescript/blob/master/src/services/services.ts"
click node_classifier "https://github.com/sage-erp-x3/typescript/blob/master/src/services/classifier.ts"
click node_codefix "https://github.com/sage-erp-x3/typescript/blob/master/src/services/codeFixProvider.ts"
click node_serverentry "https://github.com/sage-erp-x3/typescript/blob/master/src/tsserver/server.ts"
click node_session "https://github.com/sage-erp-x3/typescript/blob/master/src/server/session.ts"
click node_project "https://github.com/sage-erp-x3/typescript/blob/master/src/server/editorServices.ts"
click node_protocol "https://github.com/sage-erp-x3/typescript/blob/master/src/server/protocol.ts"
click node_js_typing "https://github.com/sage-erp-x3/typescript/blob/master/src/jsTyping/jsTyping.ts"
click node_typing_install "https://github.com/sage-erp-x3/typescript/blob/master/src/typingsInstaller/nodeTypingsInstaller.ts"
click node_standard_libs "https://github.com/sage-erp-x3/typescript/tree/master/src/lib"

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_tsc,node_options,node_parser,node_binder,node_checker,node_program,node_transform,node_emitter,node_build,node_watch toneBlue
class node_services,node_classifier,node_codefix,node_filesystem toneAmber
class node_serverentry,node_session,node_project,node_protocol toneMint
class node_js_typing,node_typing_install,node_standard_libs toneRose
class node_developer toneIndigo
```

## Components

### Compiler

- [tsc CLI](https://github.com/sage-erp-x3/typescript/blob/master/src/tsc/tsc.ts): `src/tsc/tsc.ts`
- [Options Parser](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/commandLineParser.ts): `src/compiler/commandLineParser.ts`
- [Source Parser](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/parser.ts): `src/compiler/parser.ts`
- [Binder](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/binder.ts): `src/compiler/binder.ts`
- [Type Checker](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/checker.ts): `src/compiler/checker.ts`
- [Program Builder](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/program.ts): `src/compiler/program.ts`
- [Transformers](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/transformer.ts): `src/compiler/transformer.ts`
- [JavaScript Emitter](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/emitter.ts): `src/compiler/emitter.ts`
- [Build Mode](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/tsbuild.ts): `src/compiler/tsbuild.ts`
- [Watch Mode](https://github.com/sage-erp-x3/typescript/blob/master/src/compiler/watch.ts): `src/compiler/watch.ts`

### Editor Services

- [Language Service](https://github.com/sage-erp-x3/typescript/blob/master/src/services/services.ts): `src/services/services.ts`
- [Code Classifier](https://github.com/sage-erp-x3/typescript/blob/master/src/services/classifier.ts): `src/services/classifier.ts`
- [Code Fixes](https://github.com/sage-erp-x3/typescript/blob/master/src/services/codeFixProvider.ts): `src/services/codeFixProvider.ts`

### Language Server

- [tsserver Entry](https://github.com/sage-erp-x3/typescript/blob/master/src/tsserver/server.ts): `src/tsserver/server.ts`
- [Protocol Session](https://github.com/sage-erp-x3/typescript/blob/master/src/server/session.ts): `src/server/session.ts`
- [Project Services](https://github.com/sage-erp-x3/typescript/blob/master/src/server/editorServices.ts): `src/server/editorServices.ts`
- [Server Protocol](https://github.com/sage-erp-x3/typescript/blob/master/src/server/protocol.ts): `src/server/protocol.ts`

### Project Support

- [JS Typings](https://github.com/sage-erp-x3/typescript/blob/master/src/jsTyping/jsTyping.ts): `src/jsTyping/jsTyping.ts`
- [Typings Installer](https://github.com/sage-erp-x3/typescript/blob/master/src/typingsInstaller/nodeTypingsInstaller.ts): `src/typingsInstaller/nodeTypingsInstaller.ts`
- [Standard Libraries](https://github.com/sage-erp-x3/typescript/tree/master/src/lib): `src/lib`

### Other components

- **Developer**
- **Host Filesystem**

## Connections

- Developer → tsc CLI: invokes (evidence: `README.md`)
- tsc CLI → Options Parser: parses options
- Options Parser → Program Builder: configures build
- Program Builder → Source Parser: parses sources
- Program Builder → Binder: binds symbols
- Program Builder → Type Checker: checks types
- Program Builder → Transformers: transforms sources
- Program Builder → JavaScript Emitter: emits outputs
- tsc CLI → Build Mode: supports builds
- tsc CLI → Watch Mode: supports watch
- Developer → tsserver Entry: uses editor
- tsserver Entry → Protocol Session: starts session (evidence: `src/tsserver/server.ts`)
- Protocol Session → Server Protocol: handles messages (evidence: `src/server/session.ts`)
- Protocol Session → Project Services: dispatches requests
- Project Services → Language Service: provides language features
- Language Service → Code Classifier: creates classifier (evidence: `src/services/services.ts`)
- Language Service → Code Fixes: offers fixes
- Project Services → Host Filesystem: reads config (evidence: `src/server/editorServices.ts`)
- Project Services → JS Typings: uses typing support
- JS Typings → Typings Installer: requests typings
- Program Builder → Standard Libraries: includes libraries
