# bsorrentino/java2typescript architecture

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

- Interactive diagram: https://gitdiagram.com/bsorrentino/java2typescript
- Repository: https://github.com/bsorrentino/java2typescript

## Overview

java2typescript is a Java annotation processor and runtime library that generates TypeScript declaration files for Java classes; it is not a Java-to-JavaScript transpiler. The principal workflow is to annotate Java packages or types, optionally scan classpath entries, process the declarations, and generate TypeScript declaration and runtime-binding files. The graph retains the conversion, type-model, and compatibility-specific output stages. Relationships are limited to README statements and source-index references; unsampled implementation details are not inferred.

Main entry points: [`processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`](https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/TypescriptProcessor.java) (Typescript Processor), [`core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java`](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java) (Java2TS Converter), [`core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java`](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java) (Declaration Transformer), [`core/src/main/java/org/bsc/java2typescript/TSConverterContext.java`](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSConverterContext.java) (Conversion Context)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Declaration Inputs"]
  node_java2ts_annotation["Java2TS Annotation<br/>[Java2TS.java]"]
  node_type_annotation["Type Annotation<br/>[Type.java]"]
end

subgraph group_processor["Annotation Processing"]
  node_processor_runtime["Typescript Processor"]
  node_processor_base["Processor Support"]
  node_classpath_scanner["Classpath Scanner"]
end

subgraph group_conversion["Type Conversion"]
  node_converter["Java2TS Converter"]
  node_type_model["Java Type Model<br/>[TSType.java]"]
  node_converter_context["Conversion Context"]
  node_type_conversion["Type Mapping"]
  node_namespace["Namespace Support<br/>[TSNamespace.java]"]
  node_declaration_transformer["Declaration Transformer"]
  node_static_transformer["Static Binding Transformer"]
  node_transformer_contract["Transformer Contract<br/>[TSTransformer.java]"]
end

subgraph group_outputs["Generated TypeScript"]
  node_declaration_file["Type Declarations"]
  node_binding_file["Runtime Type Bindings"]
end

node_java_project(("Java Project"))

node_java_project -->|"annotates types"| node_java2ts_annotation
node_java2ts_annotation -->|"contains declarations"| node_type_annotation
node_processor_runtime -->|"processes annotations"| node_java2ts_annotation
node_processor_runtime -->|"extends support"| node_processor_base
node_processor_runtime -->|"scans classes"| node_classpath_scanner
node_processor_runtime -->|"converts types"| node_converter
node_processor_runtime -->|"registers types"| node_type_model
node_converter -->|"transforms declarations"| node_declaration_transformer
node_converter -->|"transforms bindings"| node_static_transformer
node_converter -->|"creates context"| node_converter_context
node_converter_context -->|"maps Java types"| node_type_conversion
node_declaration_transformer -->|"renders members"| node_converter_context
node_declaration_transformer -->|"implements"| node_transformer_contract
node_static_transformer -->|"emits bindings"| node_converter_context
node_static_transformer -->|"implements"| node_transformer_contract
node_declaration_transformer -->|"inspects types"| node_type_model
node_processor_runtime -->|"generates declarations"| node_declaration_file
node_processor_runtime -->|"generates bindings"| node_binding_file

click node_java2ts_annotation "https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/annotation/Java2TS.java"
click node_type_annotation "https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/annotation/Type.java"
click node_processor_runtime "https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/TypescriptProcessor.java"
click node_processor_base "https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/AbstractProcessorEx.java"
click node_classpath_scanner "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/ClasspathScanner.java"
click node_converter "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java"
click node_type_model "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSType.java"
click node_converter_context "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSConverterContext.java"
click node_type_conversion "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSConverterStatic.java"
click node_namespace "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSNamespace.java"
click node_declaration_transformer "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java"
click node_static_transformer "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2StaticDefinitionTransformer.java"
click node_transformer_contract "https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSTransformer.java"

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_java2ts_annotation,node_type_annotation toneBlue
class node_processor_runtime,node_processor_base,node_classpath_scanner toneAmber
class node_converter,node_type_model,node_converter_context,node_type_conversion,node_namespace,node_declaration_transformer,node_static_transformer,node_transformer_contract toneMint
class node_declaration_file,node_binding_file toneRose
class node_java_project toneIndigo
```

## Components

### Declaration Inputs

- [Java2TS Annotation](https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/annotation/Java2TS.java): `processor/src/main/java/org/bsc/processor/annotation/Java2TS.java`
- [Type Annotation](https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/annotation/Type.java): `processor/src/main/java/org/bsc/processor/annotation/Type.java`

### Annotation Processing

- [Typescript Processor](https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/TypescriptProcessor.java): `processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`
- [Processor Support](https://github.com/bsorrentino/java2typescript/blob/master/processor/src/main/java/org/bsc/processor/AbstractProcessorEx.java): `processor/src/main/java/org/bsc/processor/AbstractProcessorEx.java`
- [Classpath Scanner](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/ClasspathScanner.java): `core/src/main/java/org/bsc/java2typescript/ClasspathScanner.java`

### Type Conversion

- [Java2TS Converter](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java): `core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java`
- [Java Type Model](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSType.java): `core/src/main/java/org/bsc/java2typescript/TSType.java`
- [Conversion Context](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSConverterContext.java): `core/src/main/java/org/bsc/java2typescript/TSConverterContext.java`
- [Type Mapping](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSConverterStatic.java): `core/src/main/java/org/bsc/java2typescript/TSConverterStatic.java`
- [Namespace Support](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSNamespace.java): `core/src/main/java/org/bsc/java2typescript/TSNamespace.java`
- [Declaration Transformer](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java): `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java`
- [Static Binding Transformer](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2StaticDefinitionTransformer.java): `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2StaticDefinitionTransformer.java`
- [Transformer Contract](https://github.com/bsorrentino/java2typescript/blob/master/core/src/main/java/org/bsc/java2typescript/TSTransformer.java): `core/src/main/java/org/bsc/java2typescript/TSTransformer.java`

### Generated TypeScript

- **Type Declarations**
- **Runtime Type Bindings**

### Other components

- **Java Project**

## Connections

- Java Project → Java2TS Annotation: annotates types (evidence: `README.md`)
- Java2TS Annotation → Type Annotation: contains declarations (evidence: `processor/src/main/java/org/bsc/processor/annotation/Java2TS.java`)
- Typescript Processor → Java2TS Annotation: processes annotations (evidence: `processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`)
- Typescript Processor → Processor Support: extends support (evidence: `processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`)
- Typescript Processor → Classpath Scanner: scans classes (evidence: `processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`)
- Typescript Processor → Java2TS Converter: converts types (evidence: `processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`)
- Typescript Processor → Java Type Model: registers types (evidence: `processor/src/main/java/org/bsc/processor/TypescriptProcessor.java`)
- Java2TS Converter → Declaration Transformer: transforms declarations (evidence: `core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java`)
- Java2TS Converter → Static Binding Transformer: transforms bindings (evidence: `core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java`)
- Java2TS Converter → Conversion Context: creates context (evidence: `core/src/main/java/org/bsc/java2typescript/Java2TSConverter.java`)
- Conversion Context → Type Mapping: maps Java types (evidence: `core/src/main/java/org/bsc/java2typescript/TSConverterContext.java`)
- Declaration Transformer → Conversion Context: renders members (evidence: `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java`)
- Declaration Transformer → Transformer Contract: implements (evidence: `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java`)
- Static Binding Transformer → Conversion Context: emits bindings (evidence: `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2StaticDefinitionTransformer.java`)
- Static Binding Transformer → Transformer Contract: implements (evidence: `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2StaticDefinitionTransformer.java`)
- Declaration Transformer → Java Type Model: inspects types (evidence: `core/src/main/java/org/bsc/java2typescript/transformer/TSJavaClass2DeclarationTransformer.java`)
- Typescript Processor → Type Declarations: generates declarations (evidence: `README.md`)
- Typescript Processor → Runtime Type Bindings: generates bindings (evidence: `README.md`)
