feat!: methods with out parameters now return a Record

[halildurmus]

Description

Here are three scenarios to consider when modifying method signatures:

1-) void methods with a single out parameter

When dealing with void methods that have a single out parameter, the return type of the method is replaced with the type of the out parameter.

For instance, consider the following method:

 static void tryCreate(String regionCode, PhoneNumberFormatter? formatter)  {...}

The modified signature would look like this:

 static PhoneNumberFormatter? tryCreate(String regionCode)  {...}

2-) void methods with multiple out parameters

In the case of void methods with multiple out parameters, the return type is changed to a Record with named parameters corresponding to the out parameters' types.

For example:

  void split(IMapView<String, Object?>? first, IMapView<String, Object?>? second) {...}

The updated signature would be:

  ({IMapView<String, Object?>? first, IMapView<String, Object?>? second}) split() {...}

3-) non-void methods with out parameter(s)

Finally, when dealing with non-void methods that have out parameter(s), the return type is transformed into a Record with one positional parameter representing the original return type and named parameters representing the out parameters' types.

For instance:

 int getMany(int itemsSize, List<String> items) {...}

The modified signature would be:

 (int, {List<String> items}) getMany(int itemsSize) {...}

Related Issue

Fixes #284

Type of Change

• ✨ feat -- New feature (non-breaking change which adds functionality)
• 🛠️ fix -- Bug fix (non-breaking change which fixes an issue)
• ❌ ! -- Breaking change (fix or feature that would cause existing functionality to change)
• 🧹 refactor -- Code refactor
• ✅ ci -- Build configuration change
• 📝 docs -- Documentation
• 🧪 test -- Test
• 🗑️ chore -- Chore