Version 3.1.0

.cursor/rules/create-action.mdc

@@ -0,0 +1,27 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+[ActionEntity.kt](mdc:app/src/main/java/io/github/sds100/keymapper/data/entities/ActionEntity.kt) [ActionDataEntityMapper.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/ActionDataEntityMapper.kt) [ActionData.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/ActionData.kt) [ActionId.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/ActionId.kt) [PerformActionsUseCase.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/PerformActionsUseCase.kt) [ActionUtils.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/ActionUtils.kt) [strings.xml](mdc:app/src/main/res/values/strings.xml) [ActionUiHelper.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/ActionUiHelper.kt) [CreateActionDelegate.kt](mdc:app/src/main/java/io/github/sds100/keymapper/actions/CreateActionDelegate.kt)
+
+
+When you create an action you must follow these steps:
+
+0. Ask me whether the action is editable.
+1. Create a new id in ActionId
+2. Create a new ActionData
+3. Map the data to and from an entity in ActionDataEntityMapper
+4. Give the action a category in ActionUtils
+5. If the action is editable then add it to the isEditable function in ActionUtils
+6. Create a title for the action in strings.xml
+7. Give the action a title and icon in ActionUtils. Only create a compose Icon. Ignore the drawable one.
+8. Give the action a title in ActionUiHelper
+9. Stub out the action in PerformActionsUseCase
+10. Handle creating the action in CreateActionDelegate
+
+Important things to remember:
+
+- Do not delete any existing code for other actions.
+- Follow the naming of existing code and strings and do not change them.
+- Add code near existing code for similar actions.

.cursor/rules/jetpack-compose.mdc

@@ -0,0 +1,71 @@
+---
+description: 
+globs: 
+alwaysApply: false
+---
+
+# Android Native (Jetpack Compose)
+
+# Android Jetpack Compose .cursorrules
+
+## Flexibility Notice
+**Note:** This is a recommended project structure, but be flexible and adapt to existing project structures. Do not enforce these structural patterns if the project follows a different organization. Focus on maintaining consistency with the existing project architecture while applying Jetpack Compose best practices.
+
+## Project Architecture and Best Practices
+```kotlin
+val androidJetpackComposeBestPractices = listOf(
+    "Adapt to existing project architecture while maintaining clean code principles",
+    "Follow Material Design 3 guidelines and components",
+    "Implement clean architecture with domain, data, and presentation layers",
+    "Use Kotlin coroutines and Flow for asynchronous operations",
+    "Implement dependency injection using Hilt",
+    "Follow unidirectional data flow with ViewModel and UI State",
+    "Use Compose navigation for screen management",
+    "Implement proper state hoisting and composition"
+)
+```
+
+## Folder Structure
+**Note:** This is a reference structure. Adapt to the project's existing organization.
+```plaintext
+app/
+  src/
+    main/
+      java/io/github/sds100/keymapper
+        actions/
+        constraints/
+        groups/
+        home/
+        mappings/
+            keymaps/
+        utils/
+      res/
+        values/
+        drawable/
+        mipmap/
+    test/
+    androidTest/
+```
+
+## Compose UI Guidelines
+1. Use `remember` and `derivedStateOf` appropriately
+2. Implement proper recomposition optimization
+3. Use proper Compose modifiers ordering
+4. Follow composable function naming conventions
+5. Implement proper preview annotations
+6. Use proper state management with `MutableState`
+7. Implement proper error handling and loading states
+8. Use proper theming with `MaterialTheme`
+9. Follow accessibility guidelines
+10. Implement proper animation patterns
+
+## Performance Guidelines
+1. Minimize recomposition using proper keys
+2. Use proper lazy loading with `LazyColumn` and `LazyRow`
+3. Implement efficient image loading
+4. Use proper state management to prevent unnecessary updates
+5. Follow proper lifecycle awareness
+6. Implement proper memory management
+7. Use proper background processing
+
+

CHANGELOG.md

@@ -1,3 +1,25 @@
+## [3.1.0](https://github.com/sds100/KeyMapper/releases/tag/v3.1.0)
+
+#### 10 May 2025
+
+## Added
+
+- #699 Time constraints ⏰
+- #257 Action to interact with user interface elements inside other apps.
+- #1663 Actions to stop, step forward, and step backward playing media.
+- #1682 Show "Purchased!" text next to the use button for advanced triggers.
+
+## Changed
+
+- Rename tap screen actions inside key maps.
+
+## Bug fixes
+
+- #1683 key event actions work in Minecraft and other apps again.
+- Export log files as .txt instead of .zip files.
+- #1684 Removed the redundant and broken refresh devices button when configuring a key event action because they are automatically refreshed anyway.
+- #1687 restoring key map groups would sometimes fail.
+
 ## [3.0.1](https://github.com/sds100/KeyMapper/releases/tag/v3.0.1)
 
 #### 28 April 2025

app/build.gradle

@@ -119,6 +119,9 @@ android {
     }
 
     compileOptions {
+        // Required for desugaring new Java time API on lower than API 26
+        coreLibraryDesugaringEnabled = true
+
         sourceCompatibility JavaVersion.VERSION_17
         targetCompatibility JavaVersion.VERSION_17
     }
@@ -162,7 +165,7 @@ dependencies {
 
     compileOnly project(":systemstubs")
 
-    def room_version = "2.6.1"
+    def room_version = "2.7.1"
     def coroutinesVersion = "1.9.0"
     def nav_version = '2.8.9'
     def epoxy_version = "4.6.2"
@@ -176,7 +179,7 @@ dependencies {
     implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.8.0"
 
     // random stuff
-    implementation "com.google.android.material:material:1.13.0-alpha12"
+    implementation "com.google.android.material:material:1.13.0-alpha13"
     implementation "com.github.salomonbrys.kotson:kotson:2.5.0"
     implementation "com.airbnb.android:epoxy:$epoxy_version"
     implementation "com.airbnb.android:epoxy-databinding:$epoxy_version"
@@ -189,9 +192,10 @@ dependencies {
     implementation "dev.rikka.shizuku:api:$shizuku_version"
     implementation "dev.rikka.shizuku:provider:$shizuku_version"
     implementation "org.lsposed.hiddenapibypass:hiddenapibypass:4.3"
-    proImplementation 'com.revenuecat.purchases:purchases:8.15.0'
+    proImplementation 'com.revenuecat.purchases:purchases:8.17.0'
     proImplementation "com.airbnb.android:lottie-compose:6.6.3"
     implementation("com.squareup.okhttp3:okhttp:4.12.0")
+    coreLibraryDesugaring("com.android.tools:desugar_jdk_libs:2.1.5")
 
     // splitties
     implementation "com.louiscad.splitties:splitties-bitflags:$splitties_version"
@@ -203,7 +207,7 @@ dependencies {
 
     // androidx
     implementation "androidx.legacy:legacy-support-core-ui:1.0.0"
-    implementation "androidx.core:core-ktx:1.15.0"
+    implementation "androidx.core:core-ktx:1.16.0"
 
     implementation "androidx.activity:activity-ktx:1.10.1"
     implementation "androidx.fragment:fragment-ktx:1.8.6"
@@ -221,15 +225,15 @@ dependencies {
     implementation "androidx.lifecycle:lifecycle-extensions:2.2.0"
     implementation "androidx.room:room-runtime:$room_version"
     implementation "androidx.viewpager2:viewpager2:1.1.0"
-    implementation "androidx.datastore:datastore-preferences:1.2.0-alpha01"
+    implementation "androidx.datastore:datastore-preferences:1.2.0-alpha02"
     implementation "androidx.core:core-splashscreen:1.0.1"
     implementation "androidx.activity:activity-compose:1.10.1"
     implementation "androidx.navigation:navigation-compose:2.8.9"
     implementation "androidx.navigation:navigation-fragment-compose:2.8.9"
     ksp "androidx.room:room-compiler:$room_version"
 
     // Compose
-    Dependency composeBom = platform('androidx.compose:compose-bom-beta:2025.03.01')
+    Dependency composeBom = platform('androidx.compose:compose-bom-beta:2025.04.01')
     implementation composeBom
     implementation 'androidx.compose.foundation:foundation'
     implementation "androidx.compose.ui:ui-android"