TSMapperConfiguration 1.0.4

TSMapperConfiguration

A helper NuGet package used with TSMapper to control how C# models are converted into TypeScript definitions using explicit attributes.

This package provides a clean and explicit way for developers to customize the generated TypeScript output without relying on assumptions or conventions that may not fit all projects.

Why TSMapperConfiguration?

When generating TypeScript code from C#, several challenges appear:

Mapping complex C# types instead of falling back to any

Ignoring specific properties during generation

Controlling which base classes or interfaces should appear in TypeScript

Keeping generation logic decoupled from project-specific rules

This package solves these problems by allowing you to annotate your C# code with simple, clear attributes.

Available Attributes

TSFieldAttribute

Forces a property to be generated using a specific TypeScript type name.

using TSMapperConfiguration; [TSMappingEntity] public class Product {

[TSField(FieldType = "'Home' | 'Work' | 'Other'", DefaultValue = "'Home'",FieldName = "Address_Type_Name")] public string AddressTypeName { get; set; } = "";

}

Generated TypeScript: export interface Product {

public Address_Type_Name: 'Home'|'Work'|'Other' = 'Home';

}

Without this attribute, the property would typically be generated as any.

IgnoreTSMappingAttribute

Prevents a property from being included in the generated TypeScript output.

using TSMapperConfiguration;

public class User

{

public int Id { get; set; }

[IgnoreTSMapping] public string InternalToken { get; set; }

}

Generated TypeScript:

export interface User {

Id: number;

}

Attribute: IncludedBases

IncludedBases allows you to explicitly control which base class and interfaces are included in the generated TypeScript output.

[IncludedBases(BaseClass = "EntityBase", Interfaces = "IEntityBase")]

public class Product : EntityBase, IEntityBase, IDisposable

{

}

export class Product extends EntityBase, implements IEntityBase{

}

**************NOTE***************

Intended Usage

This package is meant to be used alongside the TSMapper Visual Studio Extension.

It does not perform any generation by itself.

********************************