Fixes #2344

…rflow (#2377)

Fixes #2371

…tackFrame

Fixes #2386

…cancel() (#2384)

Avoid creating costly exception when the channel is cancelled to save a few cycles when it's not necessary. Cancellation is heavy-enough when the channel is open, so the single check won't worsen it.

* Add lint warnings on SharedFlow operations that never complete

Fixes #2340
Fixes #2368

* ~ remove awaitCancellation replacements

It was a part of the original design but was forgotten because the prototype was developeв before Kotlin 1.4.0.
It makes implementing custom SharingStarted strategies more concise.

…ch of slow-path in Mutex/Semaphore (#2396)


Fixes #2390

Co-authored-by: Gareth Pearce <[email protected]>

* Clarify thread-safety of SharedFlow methods in docs

* Override MutableSharedFlow.emit to attach a more appropriate docs than the one inherited from FlowCollector.
* Clarify thread-safety of all the MutableSharedFlow & MutableState "mutating" methods.

The latter is needed, because Flows, in general, are sequential, but shared flows provide all the necessarily synchronization themselves, so, to avoid confusion it makes sense to additionally mention thread-safety of shared flows in all the relevant mutating functions.

Fixes #2383

* Add build parameters to enable JVM IR and disable native targets
    * enable_jvm_ir enables JVM IR compiler
    * disable_native_targets disables native targets in train builds
    * enable_jvm_ir_api_check enables JVM IR API check (works only if enable_jvm_ir is set)

* Fix "Return type must be specified in explicit API mode" in 1.4.20

* Remove platform-specific dependencies on JavaFx artifacts

Fixes #2360

…es and listenable futures (#2222)

* Repair some corner cases in cancellation propagation between coroutines and listenable futures

Implement bidirectional cancellation for `future` coroutine builder.

This also:

* Refactors JobListenableFuture infrastructure so it can be reused in CoroutineScope.future and Deferred.asListenableFuture;
* Provides more descriptive `toString` implementation for the returned Future;
* Fixes stack traces in thrown exception, so it includes a call to get() that triggered the exception to be thrown;
* Hides ListenableFuture.asDeferred return type, so it can't be cast to CompletableDeferred;
* Adds more tests to cover fixed corner cases;
* Improves documentation;
* Suppresses annoying warnings in tests.

Fixes #1442

Version 1.4.2