Docs.

coil-compose-core/src/commonMain/kotlin/coil3/compose/internal/ForwardingUnconfinedCoroutineScope.kt

@@ -9,6 +9,10 @@ import kotlinx.coroutines.InternalCoroutinesApi
 import kotlinx.coroutines.Runnable
 import kotlinx.coroutines.withContext
 
+/**
+ * A [CoroutineScope] with a special [CoroutineContext] that enables [ForwardingUnconfinedCoroutineDispatcher]
+ * to enable dispatching after it is replaced in the context.
+ */
 internal fun ForwardingUnconfinedCoroutineScope(
     context: CoroutineContext,
 ) = CoroutineScope(
@@ -22,6 +26,24 @@ internal fun ForwardingUnconfinedCoroutineScope(
     }
 )
 
+/**
+ * Calls [block] with a [ForwardingUnconfinedCoroutineDispatcher] replacing the current dispatcher.
+ */
+internal suspend inline fun <T> withForwardingUnconfinedCoroutineDispatcher(
+    originalDispatcher: CoroutineDispatcher,
+    crossinline block: suspend CoroutineScope.() -> T
+): T {
+    val unconfinedDispatcher = ForwardingUnconfinedCoroutineDispatcher(originalDispatcher)
+    return withContext(unconfinedDispatcher) {
+        try {
+            block()
+        } finally {
+            // Optimization to avoid dispatching when there's nothing left to do.
+            unconfinedDispatcher.unconfined = true
+        }
+    }
+}
+
 /**
  * A [CoroutineDispatcher] that delegates to [Dispatchers.Unconfined] while [unconfined] is true
  * and [delegate] when [unconfined] is false.
@@ -56,18 +78,3 @@ internal class ForwardingUnconfinedCoroutineDispatcher(
         return "ForwardingUnconfinedCoroutineDispatcher(delegate=$delegate)"
     }
 }
-
-internal suspend inline fun <T> withForwardingUnconfinedCoroutineDispatcher(
-    originalDispatcher: CoroutineDispatcher,
-    crossinline block: suspend CoroutineScope.() -> T
-): T {
-    val unconfinedDispatcher = ForwardingUnconfinedCoroutineDispatcher(originalDispatcher)
-    return withContext(unconfinedDispatcher) {
-        try {
-            block()
-        } finally {
-            // Optimization to avoid dispatching when there's nothing left to do.
-            unconfinedDispatcher.unconfined = true
-        }
-    }
-}