ADFA-4328: add KDoc for docstring coverage (CodeRabbit)

Author: fryanpan

common/src/main/java/com/itsaky/androidide/utils/KeyedDebouncingAction.kt

@@ -31,6 +31,7 @@ class KeyedDebouncingAction<T: Any>(
 		val channel: Channel<T>,
 		val job: Job,
 	) {
+		/** Cancels this entry's worker job and closes its channel, in that order. */
 		fun cancel() {
 			// Cancel the job FIRST, then close the channel. Closing the channel first
 			// wakes a parked receive() with a ClosedReceiveChannelException before the
@@ -55,6 +56,10 @@ class KeyedDebouncingAction<T: Any>(
 		entry.channel.trySend(key)
 	}
 
+	/**
+	 * Creates a new [ActionEntry]: a CONFLATED channel plus a worker coroutine that debounces
+	 * incoming keys and runs [action] for the latest one, stopping cleanly when the channel is closed.
+	 */
 	@OptIn(ExperimentalCoroutinesApi::class)
 	private fun createEntry(): ActionEntry<T> {
 		val channel = Channel<T>(Channel.CONFLATED)

common/src/test/java/com/itsaky/androidide/utils/KeyedDebouncingActionCancelTest.kt

@@ -27,6 +27,7 @@ import kotlin.time.Duration.Companion.milliseconds
  */
 class KeyedDebouncingActionCancelTest {
 
+  /** Cancelling an entry whose worker is parked on receive() must not surface an uncaught exception. */
   @Test
   fun `cancelling a parked worker does not leak a ClosedReceiveChannelException`() = runBlocking {
     val uncaught = AtomicReference<Throwable?>(null)