v8.0.0

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