SharpTS.Sdk 1.0.9

SharpTS.Sdk

MSBuild SDK for compiling TypeScript directly to .NET assemblies using SharpTS.

SharpTS.Sdk composes with the installed Microsoft.NET.Sdk and uses the compiler bundled in the selected package version. It does not require a global sharpts tool installation.

Quick Start

Create a new project file:

<Project Sdk="SharpTS.Sdk/1.0.7">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <SharpTSEntryPoint>src/main.ts</SharpTSEntryPoint>
  </PropertyGroup>
</Project>

Build your project:

dotnet build

Features

• Compiles TypeScript directly to .NET IL (no JavaScript intermediate)
• Automatic import discovery via ModuleResolver
• tsconfig.json integration
• Optional TypeScript .d.ts declaration output
• Standard MSBuild commands (dotnet build, dotnet clean)
• MSBuild-compatible error output for IDE integration

MSBuild Properties

tsconfig.json Integration

The SDK automatically reads tsconfig.json if present. The MSBuild task extracts:

MSBuild properties take precedence over tsconfig.json values.

The compiler also receives the config through --project, so extends, strictness, baseUrl/paths, selectable moduleResolution, and lib/types/typeRoots use the same project model as the CLI. files[0] remains the default runtime entry point for SDK IL output; use sharpts -p or sharpts --build to type-check every files/include root.

Example Projects

Minimal Project

<Project Sdk="SharpTS.Sdk/1.0.7">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <SharpTSEntryPoint>src/main.ts</SharpTSEntryPoint>
  </PropertyGroup>
</Project>

With Decorators

<Project Sdk="SharpTS.Sdk/1.0.7">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    <SharpTSEntryPoint>src/app.ts</SharpTSEntryPoint>
    <SharpTSDecorators>true</SharpTSDecorators>
    <SharpTSEmitDecoratorMetadata>true</SharpTSEmitDecoratorMetadata>
  </PropertyGroup>
</Project>

With tsconfig.json

Project structure:

myproject/
├── myproject.csproj
├── tsconfig.json
└── src/
    └── main.ts

myproject.csproj:

<Project Sdk="SharpTS.Sdk/1.0.7">
  <PropertyGroup>
    <TargetFramework>net10.0</TargetFramework>
    
  </PropertyGroup>
</Project>

tsconfig.json:

{
  "compilerOptions": {
    "target": "ES2020",
    "module": "ESNext",
    "strict": true,
    "preserveConstEnums": true
  },
  "files": ["src/main.ts"]
}

Version Specification

You can pin the SDK version in global.json:

{
  "msbuild-sdks": {
    "SharpTS.Sdk": "1.0.7"
  }
}

Build Commands

# Build the project
dotnet build

# Clean output files
dotnet clean

# Publish
dotnet publish

# Build in Release mode
dotnet build -c Release

Error Codes

System Requirements

• .NET 10 SDK or later (required for building projects)
• Visual Studio 2026 18.0+ (recommended for IDE support)
• MSBuild 18.0+ (included with .NET 10 SDK)

SharpTS.Sdk targets .NET 10 directly for optimal performance and modern features.

License

MIT License - see the main SharpTS repository for details.