What's the story with SwiftSyntax and API stability?

I have a project which makes heavy use of SwiftSyntax, and it requires quite a bit of maintenance every time a language version is released. A lot of it seems to boil down to types being renamed, and other seemingly arbitrary changes.

I know there is a disclaimer that this library should not be considered stable, but is there a rhyme or reason to these changes? Also is there any kind of planned/expected trajectory as far as when the API might reach a more stable state?

2 Likes