Skip to content

Releases: Aleph-Alpha/ts-rs

v10.0.0

19 Sep 19:55
Compare
Choose a tag to compare

While v10.0.0 is a technically breaking change, we expect it to be a drop-in replacement for almost all users.

Changes to HashMap<K, V> (& friends)

In this release, we've changed how HashMap<K, V> is represented in TypeScript.
Before v10, ts-rs generated { [key: K]: V }. This was never technically correct, resulting in tsc accepting some code which it should not have. Additionally, this resulted in issues when e.g trying to use an enum as key.
With v10, we now generate { [key in K]?: V } instead.

What's New?

  • Multiple types can be exported to the same file using #[ts(export_to = "..")]
  • #[ts(as = "..")] and #[ts(type = "..")] now also work on enum variants
  • Support for more crates (bson, smol_str)

Full changelog

New Contributors

v9.0.1

24 Jul 17:02
af15ff9
Compare
Choose a tag to compare

This is a small patch release fixing a single bug:

Fixes:

  • Allow for flattening of generic parameters by @NyxCode in #336

Full Changelog: v9.0.0...v9.0.1

v9.0.0

20 Jun 17:21
Compare
Choose a tag to compare

While v9.0.0 is a technically breaking change, we expect it to be a drop-in replacement for almost all users.
Only code interacting with TS::dependency_types and TS::generics will need to be adjusted.

What's new?

Removal of TypeList

The biggest change of v9.0.0 is an internal one: We removed TypeList from the API.
This fixes the long-standing issue of complex types failing to compile with

  • overflow evaluating the requirement or
  • reached the recursion limit

Even if you did not run into those, we do expect this change to also improve compilation times.

Allow for _ in #[ts(as = "..")]

Similar to how it works in serde, _ can be used in #[ts(as = "..")] to refer to the type of the field.
This is particularly useful for more complex type overrides.

Allow #[ts(as = "..")] and #[ts(type = "..")] on structs and enums

These two attributes can now be used directly on structs and enums.
Previously, it was necessary to add these attributes on every field where the type was used.
This feature is particularly useful for exposing newtypes transparently.

To see a list of all changes, check out CHANGELOG.md!

All changes

New Contributors

Full Changelog: v8.1.0...v9.0.0

v8.1.0

22 Mar 13:55
Compare
Choose a tag to compare

v8.1.0 is a mostly a small follow-up to v8.0.0, fixing a couple of rough edges.

We expect v8.1.0 to be fully compatible to v8.0.0.

Additionally, we've added support for serde_json behind the serde-json-impl cargo feature.
This might seem like a small change, but a lot of work over the past months has now paid off and made cleanly supporting serde_json::Value possible.

Features

  • Add #[ts(crate = "..")] to allow usage of #[derive(TS)] from other proc-macro crates (#274)
  • Add support types from serde_json behind cargo feature serde-json-impl (#276)
  • HashMap and similar types are now represented as { [key: K]: V } instead of Record<K, V> (#277)

Fixes

  • Macro expansion for types with generic parameters now works without the TS trait in scope (#281)
  • Fix flattening a struct that contains a flattened enum (#282)

Full Changelog: v8.0.0...v8.1.0

v8.0.0

18 Mar 12:42
160b355
Compare
Choose a tag to compare

After a lot of work and quite some time, we're happy to announce v8.0.0 of ts-rs. 🥳

Migration from 7.x.x

While this is a major release, we do expect that it's drop-in upgrade for most usecases.
However, if your setup is more involved (e.g interacting with the TS trait directly, doing post-processing on the output, etc.), some changes might be necessary.

If you're having any trouble migrating, please feel free to open a discussion or issue, we're happy to help.

Highlights

  • Automatic export of dependencies
    If a struct or enum is annotated with #[ts(export)], all of its dependencies will be exported automatically, even if they are not annotated with #[ts(export)]. This behaviour is more convenient and always results in correct import statements.
    More importantly, this enables the use of ts-rs within libraries. Consumers of such a library will automatically get a copy of the types their types depend on.
  • New handling of generic types
    Handling of generic types has been massively improved in this release. Not only is it way more robust than before, but we're also able to support all the edge-cases we couldn't before. For example, structs with trait bounds, generic type aliases and structs containing associated types are all supported now!
  • Improved handling for enums
    Support for enums and their different representations (internally tagged, externally tagged, untagged) has been massively improved in this release, thanks to @escritorio-gustavo!
    In all these cases, ts-rs's behaviour matches more or less exactly with that of serde.
  • Easier exports
    Exporting types is now much easier than before. For one, running cargo test now exports all dependencies of types annotated with #[ts(export)]. The output directory can now be customized by setting the TS_RS_EXPORT_DIR environment variable.
    For more complicated setups, where #[ts(export)] is not sufficient, we've reworked the API for exporting types from code.

Acknowledgements

We've had a lot of new contributors since the last release!
I'm also excited to welcome @escritorio-gustavo as a new maintainer, who has been instrumental in making 8.0.0 happen!

Breaking changes

  • Export types as type instead of ìnterface (#203)
  • Automatically export all dependencies when using #[ts(export)], add TS::dependency_types() (#221)
  • Remove support for "skip_serializing", "skip_serializing_if" and "skip_deserializing". (#204)
    • Initially supporting these by skipping a field was a mistake. If a user wishes to skip a field, they can still
      annotate it with #[ts(skip)]
  • Added TS::dependency_types() (#221)
  • Added TS::generics() (#241)
  • Added TS::WithoutGenerics (#241)
  • Removed TS::transparent() (#243)
  • Handling of output paths (#247, #250, #256)
    • All paths specified using #[ts(export_to = "...")] are now relative to TS_RS_EXPORT_DIR, which defaults to ./bindings/
  • Replace TS::export with TS::export, TS::export_all and TS::export_to_all (#263)

Features

  • Implement #[ts(as = "..")] (#174)
  • For small arrays, generate tuples instead of Array<T> (#209)
  • Implement #[ts(optional = nullable)] (#213)
  • Allow inlining of fields with generic types (#212, #215, #216)
  • Allow flattening enum fields (#206)
  • Add semver-impl cargo feature with support for the semver crate (#176)
  • Support HashMap with custom hashers (#173)
  • Add import-esm cargo feature to import files with a .js extension (#192)
  • Implement #[ts(...)] equivalents for #[serde(tag = "...")], #[serde(tag = "...", content = "...")] and #[serde(untagged)] (#227)
  • Support #[serde(untagged)] on individual enum variants (#226)
  • Support for #[serde(rename_all_fields = "...")] (#225)
  • Export Rust doc comments/attributes on structs/enums as TSDoc strings (#187)
  • Result, Option, HashMap and Vec had their implementations of TS changed (#241)
  • Implement #[ts(...)] equivalent for #[serde(tag = "...")] being used on a struct with named fields (#244)
  • Implement #[ts(concrete(..))] to specify a concrete type for a generic parameter (#264)
  • Implement #[ts(bound = "...")] to manually override the generated where clause (#269)

Fixes

  • Fix #[ts(skip)] and #[serde(skip)] in variants of adjacently or internally tagged enums (#231)
  • rename_all with camelCase produces wrong names if fields were already in camelCase (#198)
  • Improve support for references (#199)
  • Generic type aliases generate correctly (#233)
  • Improve compiler errors (#257)
  • Update dependencies (#255)

Full Changelog: v7.1.1...v8.0.0