Document paneTitle behavior on title @param of public screen composables

ChannelsScreen, ChatsScreen, and ThreadsScreen route their title parameter into Modifier.semantics { paneTitle = ... } on the screen root. The @param title KDoc now states that contract so integrators know the value is announced by TalkBack when the screen appears as a pane.

Author: andremion

stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/channels/ChannelsScreen.kt

@@ -69,7 +69,8 @@ import io.getstream.chat.android.ui.common.state.channels.actions.ViewInfo
  * You can use the default implementation by not passing in an instance yourself, or you
  * can customize the behavior using its parameters.
  * @param viewModelKey Key to differentiate between instances of [ChannelListViewModel].
- * @param title Header title.
+ * @param title Header title. Also drives the screen's `paneTitle` semantic, announced by TalkBack
+ * when the screen appears as a pane (e.g. an adaptive-layout pane or a Compose Navigation route).
  * @param isShowingHeader If we show the header or hide it.
  * @param searchMode The search mode for the screen.
  * @param onHeaderActionClick Handler for the default header action.

stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/chats/ChatsScreen.kt

@@ -108,6 +108,8 @@ import kotlin.math.abs
  * When the initial [ChannelViewModelFactory] is requested (before a channel is selected),
  * `channelId`, `messageId`, and `parentMessageId` are `null`.
  * @param title The title displayed in the list pane top bar. Default is `"Stream Chat"`.
+ * Also drives the list pane's `paneTitle` semantic, announced by TalkBack when the list pane
+ * appears or becomes active (e.g. switching between panes in the adaptive layout).
  * @param searchMode The current search mode. Default is [SearchMode.None].
  * @param listContentMode The mode for displaying the list content. Default is [ChatListContentMode.Channels].
  * @param onBackPress Callback invoked when the user presses the back button.

stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/threads/ThreadsScreen.kt

@@ -40,7 +40,8 @@ import io.getstream.chat.android.models.Thread
  * It can be used without most parameters for default behavior, that can be tweaked if necessary.
  *
  * @param viewModelFactory The factory used to build the [ThreadListViewModel].
- * @param title Header title.
+ * @param title Header title. Also drives the screen's `paneTitle` semantic, announced by TalkBack
+ * when the screen appears as a pane (e.g. an adaptive-layout pane or a Compose Navigation route).
  * @param onHeaderAvatarClick Handle for when the user clicks on the header avatar.
  * @param onThreadClick Handler for Thread item clicks.
  */