Add KDoc to the authentication, logout, preferences and share API interfaces

Cover the remaining interfaces of features/login, features/logout,
features/preferences and features/share, along with their members and parameters.

Points recorded here: AccountProviderAccessControl returns true on a build with no
enterprise restriction, ExtraDeveloperOptionsRenderer is bound to a no-op in the
standard build, DirectLogoutView draws nothing until a logout event is sent, and
CacheService exists because clearing a cache destroys the client and the app has
to react.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

features/login/api/src/main/kotlin/io/element/android/features/login/api/LoginIntentResolver.kt

@@ -8,6 +8,13 @@
 
 package io.element.android.features.login.api
 
+/**
+ * Extracts the login parameters from a link, so that a deployment can hand out a URL that pre-fills the sign-in screen.
+ */
 interface LoginIntentResolver {
+    /**
+     * @param uriString the link the app was opened with.
+     * @return the account provider and login hint to pre-fill, or `null` when the link is not a login link.
+     */
     fun parse(uriString: String): LoginParams?
 }

features/login/api/src/main/kotlin/io/element/android/features/login/api/accesscontrol/AccountProviderAccessControl.kt

@@ -8,6 +8,14 @@
 
 package io.element.android.features.login.api.accesscontrol
 
+/**
+ * Enforces the restriction an enterprise deployment can put on which account providers the user may sign in to.
+ */
 interface AccountProviderAccessControl {
+    /**
+     * Whether sign-in to this provider is permitted; `true` on a build with no such restriction.
+     *
+     * @param accountProviderUrl the server the user is trying to use.
+     */
     suspend fun isAllowedToConnectToAccountProvider(accountProviderUrl: String): Boolean
 }

features/logout/api/src/main/kotlin/io/element/android/features/logout/api/direct/DirectLogoutView.kt

@@ -10,7 +10,17 @@ package io.element.android.features.logout.api.direct
 
 import androidx.compose.runtime.Composable
 
+/**
+ * Renders the confirmation dialogs of logging out directly, in particular the warning shown when the user would lose their room keys.
+ *
+ * It draws nothing until the host screen sends a logout event.
+ */
 fun interface DirectLogoutView {
+    /**
+     * Draws whichever dialog the current state calls for.
+     *
+     * @param state the state produced by the direct logout presenter.
+     */
     @Composable
     fun Render(state: DirectLogoutState)
 }

features/preferences/api/src/main/kotlin/io/element/android/features/preferences/api/CacheService.kt

@@ -11,6 +11,9 @@ package io.element.android.features.preferences.api
 import io.element.android.libraries.matrix.api.core.SessionId
 import kotlinx.coroutines.flow.Flow
 
+/**
+ * Announces that a session's cache has been cleared, since clearing it destroys the client and the app has to react.
+ */
 interface CacheService {
     /**
      * A flow of [SessionId], can let the app to know when the

features/preferences/api/src/main/kotlin/io/element/android/features/preferences/api/ExtraDeveloperOptionsRenderer.kt

@@ -14,6 +14,11 @@ import androidx.compose.ui.Modifier
  * Component for rendering extra developer options in the preferences screen.
  */
 interface ExtraDeveloperOptionsRenderer {
+    /**
+     * Draws the extra options. The standard build binds a no-op implementation, so only the builds that actually add options provide a real one.
+     *
+     * @param modifier layout modifier for the container.
+     */
     @Composable
     fun Render(modifier: Modifier)
 }

features/share/api/src/main/kotlin/io/element/android/features/share/api/OnSharedData.kt

@@ -11,5 +11,8 @@ package io.element.android.features.share.api
  * Post-processing to be done once a [ShareIntentData] has been consumed.
  */
 fun interface OnSharedData {
+    /**
+     * @param data the shared content that has just been handled, so any temporary copy of it can be released.
+     */
     operator fun invoke(data: ShareIntentData)
 }

features/share/api/src/main/kotlin/io/element/android/features/share/api/ShareIntentHandler.kt

@@ -9,10 +9,14 @@ package io.element.android.features.share.api
 
 import android.content.Intent
 
+/**
+ * Recognises the intents another app uses to share content into this one, and resolves what was shared.
+ */
 interface ShareIntentHandler {
     /**
      * This methods aims to handle incoming share intents and parse its data.
      *
+     * @param intent the intent the app was started with.
      * @return the [ShareIntentData] if it could be resolved, or null.
      */
     fun handleIncomingShareIntent(