Fonlow.TypeScriptCodeDomCore 3.1.0

CodeDOM in .NET (Framework) has come with 3 providers:

1. CSharpCodeProvider
2. VBCodeProvider
3. JScriptCodeProvider

While JSCriptCodeProvider is good enough for generating JavaScript codes for Internet Explorer however IE had been discoutinued. TypeScriptCodeProvider provides extra benefits over a "JavaScript Provider":

1. Strongly typed interfaces and function prototypes for validation during design time and compile time.
2. Re-use some portion of CodeDOM codes if a code generator toolset like WebApiClientGen and OpenApiClientGen targets multiple OO languages.
3. Naturally and inheriently adapt the evolution of the JavaScript standard as long as TypeScript will.
4. Live well with TypeScript frameworks like Angular 2+ and Auralia. And with Angular Reactive Forms, runtime validation could become possible, similar to the use cases of using validation attributes to decorate a member property of a .NET class.

What Supported and Not

CodeDOM cover almost every essential C# language features, however, not every features of such coverage is applicable to TypeScript.

GeneratorSupport Enum

bool ICodeGenerator.Supports(GeneratorSupport supports)
{
	return (supports & supported) != 0;
}

const GeneratorSupport supported = GeneratorSupport.ArraysOfArrays
	| GeneratorSupport.MultidimensionalArrays
	| GeneratorSupport.TryCatchStatements
	| GeneratorSupport.DeclareValueTypes
	| GeneratorSupport.DeclareEnums
	| GeneratorSupport.StaticConstructors
	| GeneratorSupport.DeclareInterfaces
	| GeneratorSupport.DeclareDelegates
	| GeneratorSupport.NestedTypes
	| GeneratorSupport.MultipleInterfaceMembers
	| GeneratorSupport.ComplexExpressions
	| GeneratorSupport.GenericTypeReference
	| GeneratorSupport.GenericTypeDeclaration
   ;

Supported CodeDOM Classes

Most supported classes are covered by unit testing, while some are covered by integration testing in some code generator projects, marked as "Indirectly" in the table below.

Hints:

• There are integration tests in PocoToTS, WebApiClientGen and OpenApiClientGen, covering some classes like XxxCollection.

Examples Utilizing TypeScriptProvider

• Unit Testing
• Integration Testing with PocoToTS
• Code Generator for Angular Reactive Forms

Generated Code Examples

• Client API codes with typed forms and validators generated from Web API
• OpenAPI to Angular 5+ and integration tests for pet.yaml
• OpenAPI to Angular Reactive Typed Forms
• OpenAPI to Aurelia and integration tests for pet.yaml
• OpenAPI to AXIOS and integration tests for pet.yaml
• OpenAPI to Fetch API and integration tests for pet.yaml
• OpenAPI to jQuery and integration tests for pet.yaml

CodeDOM Features Applicable to TypeScript but not Supported in TypeScriptProvider

• CodeComment
• CodeGotoStatement
• CodeLabeledStatement

CodeDOM Features Not Applicable to TypeScript

• CodeAttachEventStatement
• CodeChecksumPragma
• CodeDefaultValueExpression
• CodeDelegateCreateExpression
• CodeDelegateInvokeExpression
• CodeDirectionExpression
• CodeEntryPointMethod
• CodeEventReferenceExpression
• CodeLinePragma
• CodeMemberEvent
• CodeNamespaceImport
• CodeNamespaceImportCollection
• CodePropertySetValueReferenceExpression
• CodeRemoveEventStatement
• CodeSnippetCompileUnit
• CodeTypeConstructor . Alternative.