Update documentation for command selection behavior in MessageComposer and related components

Author: andremion

stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/messages/attachments/AttachmentCommandPicker.kt

@@ -91,6 +91,12 @@ internal fun AttachmentCommandPicker(
     }
 }
 
+/**
+ * Command grid row.
+ *
+ * @param enabled Controls the item's visual state only (dimmed when `false`). Taps still invoke
+ * [onCommandSelected] regardless, so the caller can surface feedback for disabled commands.
+ */
 @Composable
 private fun CommandItem(
     command: Command,

stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/messages/composer/MessageComposer.kt

@@ -89,7 +89,10 @@ import io.getstream.chat.android.ui.common.utils.MediaStringUtil
  * @param onLinkPreviewClick Handler when the user taps on a link preview.
  * @param onCancelLinkPreviewClick Handler when the user taps on the cancel link preview.
  * @param onUserSelected Handler when the user taps on a user suggestion item.
- * @param onCommandSelected Handler when the user taps on a command suggestion item.
+ * @param onCommandSelected Handler for every tap on a command suggestion item, regardless of the
+ * command's availability in the current composer action. The default dispatches available commands
+ * to the [viewModel] and surfaces a Toast for unavailable ones; overriding replaces both branches,
+ * so the override is responsible for filtering and any unavailability feedback.
  * @param onAlsoSendToChannelChange Handler when the "Also send to channel" checkbox is changed.
  * @param onActiveCommandDismiss Called when the user taps the dismiss button on the active command chip.
  * @param recordingActions The actions that can be performed on an audio recording.

stream-chat-android-compose/src/main/java/io/getstream/chat/android/compose/ui/messages/composer/internal/suggestions/CommandSuggestionItem.kt

@@ -40,6 +40,12 @@ import io.getstream.chat.android.compose.ui.util.extensions.internal.iconRes
 import io.getstream.chat.android.compose.ui.util.extensions.internal.isPolychromaticIcon
 import io.getstream.chat.android.models.Command
 
+/**
+ * Command suggestion row.
+ *
+ * @param enabled Controls the item's visual state only (dimmed when `false`). Taps still invoke
+ * [onCommandSelected] regardless, so the caller can surface feedback for disabled commands.
+ */
 @Composable
 internal fun CommandSuggestionItem(
     command: Command,

stream-chat-android-ui-common/src/main/kotlin/io/getstream/chat/android/ui/common/feature/messages/composer/MessageComposerController.kt

@@ -970,9 +970,7 @@ public class MessageComposerController(
      * overwrite an existing stash (in-command input is command-specific and not preserved across
      * command switches).
      *
-     * No-op while the composer is in edit mode: the backend does not dispatch slash commands on
-     * message edits, so the combination is disallowed client-side to avoid emitting literal
-     * `/command` text as the edit payload.
+     * No-op while the composer is in edit mode.
      *
      * @param command The command that was selected.
      */