SupportscalablytypedTo

SupportscalablytypedTo is an experimental interoperability tool aimed at simplifying the integration of TypeScript libraries into Scala.js projects by leveraging the scal.scalablytyped project. The goal is to provide a workflow and code generation that translates TypeScript type definitions into Scala facade types, allowing Scala developers to consume external JavaScript libraries with type safety.

The tool typically comprises three parts: an sbt plugin, a type-definition generator, and a runtime facade library. The sbt plugin coordinates the download and parsing of TypeScript definition files (.d.ts), the generator maps TypeScript constructs such as interfaces, classes, enums, unions, and generics to equivalent Scala concepts (for example, interfaces and classes become traits and case classes, unions map to sealed traits, optional properties become Option, and function types become JavaScript function types). The runtime facades provide lightweight wrappers for invoking JavaScript APIs from Scala.js.

Usage usually involves adding a dependency on the runtime facade, configuring a source of TypeScript typings, and invoking the generator as part of the build, so that behind the scenes Scala sources stay in sync with the TypeScript definitions. Generated code can then be used directly in Scala.js code with compile-time type checking.

Limitations include incomplete coverage of complex TypeScript features, maintenance burden when upstream typings change, and potential mismatches in runtime semantics between TypeScript and Scala.js. Ongoing work focuses on improving mapping fidelity and supporting more TS features, with the project commonly discussed alongside scal.scalablytyped and Scala.js communities.