feat: add API for programmatic usage

API.md

@@ -0,0 +1,29 @@
+Léon can be called programmatically from other applications to clean URLs.  
+Just like the user-facing application it is based on the standard mechanism of intents.
+
+To send text to Léon for cleaning, create an `Intent` with action `com.svenjacobs.app.leon.CLEAN`
+and put the text to clean as an extra with key `Intent.EXTRA_TEXT`.
+
+For Compose, use
+[rememberLauncherForActivityResult](https://developer.android.com/reference/kotlin/androidx/activity/compose/package-summary#rememberLauncherForActivityResult(androidx.activity.result.contract.ActivityResultContract,kotlin.Function1))
+from `androidx.activity:activity-compose`.
+
+```kotlin
+val launcher = rememberLauncherForActivityResult(
+    ActivityResultContracts.StartActivityForResult()
+) { result ->
+    if (result.resultCode == Activity.RESULT_OK) {
+        val cleanedText = result.data?.getStringExtra(Intent.EXTRA_TEXT)
+        // Do something with cleanedText
+    }
+}
+
+val intent = Intent("com.svenjacobs.app.leon.CLEAN").apply {
+    putExtra(Intent.EXTRA_TEXT, "text to clean")
+}
+launcher.launch(intent)
+```
+
+For legacy Android development you would use
+[startActivityForResult](https://developer.android.com/reference/android/app/Activity#startActivityForResult(android.content.Intent,%20int))
+and the related API for Fragments.

README.md

@@ -37,6 +37,11 @@ Did you find a bug or have an idea of how the app could be improved? Please repo
 [bugs](https://github.com/svenjacobs/leon/issues) or give
 [feedback](https://github.com/svenjacobs/leon/discussions).
 
+## API
+
+It is possible to call Léon programmatically from other applications.  
+See [API.md](API) for details.
+
 ## Technical implementation
 
 This app is also meant as a blueprint for modern Android development, presenting and evaluating

app/src/main/AndroidManifest.xml

@@ -54,6 +54,12 @@
                 <category android:name="android.intent.category.DEFAULT" />
                 <data android:mimeType="text/plain" />
             </intent-filter>
+
+            <!-- For programmatic use from other applications -->
+            <intent-filter>
+                <action android:name="com.svenjacobs.app.leon.CLEAN" />
+                <category android:name="android.intent.category.DEFAULT" />
+            </intent-filter>
         </activity>
 
         <!-- Handle browser intents. -->

app/src/main/kotlin/com/svenjacobs/app/leon/MainActivity.kt

@@ -23,10 +23,10 @@ import android.content.Intent
 import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.activity.compose.setContent
+import androidx.activity.enableEdgeToEdge
 import androidx.browser.customtabs.CustomTabsClient
 import androidx.browser.customtabs.CustomTabsServiceConnection
 import androidx.compose.runtime.mutableStateOf
-import androidx.core.view.WindowCompat
 import androidx.lifecycle.Lifecycle
 import androidx.lifecycle.lifecycleScope
 import androidx.lifecycle.repeatOnLifecycle
@@ -43,7 +43,7 @@ class MainActivity : ComponentActivity() {
 	override fun onCreate(savedInstanceState: Bundle?) {
 		super.onCreate(savedInstanceState)
 
-		WindowCompat.setDecorFitsSystemWindows(window, false)
+		enableEdgeToEdge()
 
 		onIntent(intent)
 

app/src/main/kotlin/com/svenjacobs/app/leon/ProcessTextActivity.kt

@@ -24,6 +24,8 @@ import android.os.Bundle
 import androidx.activity.ComponentActivity
 import androidx.annotation.RequiresApi
 import com.svenjacobs.app.leon.core.domain.CleanerService
+import com.svenjacobs.app.leon.inject.AppContainer.AppDataStoreManager
+import kotlinx.coroutines.flow.firstOrNull
 import kotlinx.coroutines.runBlocking
 
 @RequiresApi(Build.VERSION_CODES.M)
@@ -32,10 +34,31 @@ class ProcessTextActivity : ComponentActivity() {
 	override fun onCreate(savedInstanceState: Bundle?) {
 		super.onCreate(savedInstanceState)
 
+		when (intent.action) {
+			ACTION_CLEAN -> actionClean()
+			Intent.ACTION_PROCESS_TEXT -> actionProcessText()
+			else -> cancel()
+		}
+
+		finish()
+	}
+
+	private fun actionClean() {
+		val text = intent.getStringExtra(Intent.EXTRA_TEXT)
+
+		when {
+			text.isNullOrBlank() -> cancel()
+			else -> result(text, Intent.EXTRA_TEXT)
+		}
+	}
+
+	private fun actionProcessText() {
 		val text = intent.getCharSequenceExtra(Intent.EXTRA_PROCESS_TEXT)?.toString()
 		val readonly = intent.getBooleanExtra(Intent.EXTRA_PROCESS_TEXT_READONLY, false)
 
 		when {
+			text.isNullOrBlank() -> cancel()
+
 			// If readonly, delegate to MainActivity
 			readonly -> startActivity(
 				Intent(this, MainActivity::class.java).apply {
@@ -45,21 +68,33 @@ class ProcessTextActivity : ComponentActivity() {
 				},
 			)
 
-			text.isNullOrBlank() -> setResult(RESULT_CANCELED)
+			else -> result(text, Intent.EXTRA_PROCESS_TEXT)
+		}
+	}
 
-			// Needs to run with runBlocking or else setResult() won't work
-			else -> runBlocking {
-				val result = CleanerService().clean(text)
+	private fun result(text: String, key: String) {
+		// Needs to run with runBlocking or else setResult() won't work
+		runBlocking {
+			val decodeUrl = AppDataStoreManager.urlDecodeEnabled.firstOrNull() ?: false
+			val result = CleanerService().clean(
+				text = text,
+				decodeUrl = decodeUrl,
+			)
 
-				setResult(
-					RESULT_OK,
-					Intent().apply {
-						putExtra(Intent.EXTRA_PROCESS_TEXT, result.cleanedText)
-					},
-				)
-			}
+			setResult(
+				RESULT_OK,
+				Intent().apply {
+					putExtra(key, result.cleanedText)
+				},
+			)
 		}
+	}
 
-		finish()
+	private fun cancel() {
+		setResult(RESULT_CANCELED)
+	}
+
+	private companion object {
+		private const val ACTION_CLEAN = "com.svenjacobs.app.leon.CLEAN"
 	}
 }

app/src/main/kotlin/com/svenjacobs/app/leon/ui/screens/main/views/BottomBar.kt

@@ -18,7 +18,6 @@
 
 package com.svenjacobs.app.leon.ui.screens.main.views
 
-import androidx.compose.foundation.layout.navigationBarsPadding
 import androidx.compose.material3.Icon
 import androidx.compose.material3.NavigationBar
 import androidx.compose.material3.NavigationBarItem
@@ -42,7 +41,7 @@ internal fun BottomBar(navController: NavHostController, modifier: Modifier = Mo
 	)
 
 	NavigationBar(
-		modifier = modifier.navigationBarsPadding(),
+		modifier = modifier,
 	) {
 		val navBackStackEntry by navController.currentBackStackEntryAsState()
 		val currentDestination = navBackStackEntry?.destination