Add map function to apply style transition during style load

[kiryldz]

Summary of changes

Introduce new function MapboxMap.setStyleTransition and deprecate Style.setStyleTransition.

Main idea is that we need to apply transition options in the correct moment of time during style is loading while our current API allows to actually operate on Style object when style is already fully loaded.

Please take a look at the visuals, what we do there is:

• load first streets style with following options TransitionOptions.Builder().duration(0).build()
• wait for 2 seconds and load dark style with TransitionOptions.Builder().duration(5000).delay(3000).build()

User impact (optional)

Following pseudo-code:

loadStyleUri(Style.MAPBOX_STREETS) { firstStyle ->
  firstStyle.styleTransition = TransitionOptions.Builder()
     .duration(0)
     .build()
}

should be replaced with:

loadStyleUri(
  styleUri = Style.MAPBOX_STREETS,
  styleTransitionOptions = TransitionOptions.Builder()
     .duration(0)
     .build()
)

Pull request checklist:

• Briefly describe the changes in this PR.
• Include before/after visuals or gifs if this PR includes visual changes.

Before	After
incorrect.mp4	correct.mp4

• Write tests for all new functionality. If tests were not written, please explain why.
• Optimize code for java consumption (@JvmOverloads, @file:JvmName, etc).
• Add example if relevant.
• Document any changes to public APIs.
• Run ./gradlew apiDump to update generated api files, if there's public API changes, otherwise the verify-kotlin-binary-compatibility CI will fail.
• Apply changelog label ('breaking change', 'bug 🪲', 'build', 'docs', 'feature 🍏', 'performance ⚡', 'testing 💯') or use the label 'skip changelog'
• Add an entry inside this element for inclusion in the mapbox-maps-android changelog: <changelog>Add overloaded MapboxMap.loadStyleUri, MapboxMap.loadStyleJson, MapboxMap.loadStyle with TransitionOptions parameter allowing to apply transition style being loaded.</changelog>.
• If this PR is a v10.[version] release branch fix / enhancement, merge it to main firstly and then port to v10.[version] release branch.

Fixes: < Link to related issues that will be fixed by this pull request, if they exist >

PRs must be submitted under the terms of our Contributor License Agreement CLA.

[ank27]

Since we apply styleTransition to map now, does the same transition will be applied when switching between styles?

[kiryldz]

Since we apply styleTransition to map now, does the same transition will be applied when switching between styles?

Previously it was not applied at all but yes, I did even state in docs that user could set it once - and it will be applied to all style loads happening afterwards.

[kiryldz]

Since we apply styleTransition to map now, does the same transition will be applied when switching between styles?

Previously it was not applied at all but yes, I did even state in docs that user could set it once - and it will be applied to all style loads happening afterwards.

@ank27 correction after deeper look - we do actually reset transition options for the next style, it's reflected in code now, PTAL

[yunikkk]

1 nit

[pengdev]

LGTM % nits