Feature/1394 kernel remapping

.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,16 +1,58 @@
-## [3.1.0](https://github.com/sds100/KeyMapper/releases/tag/v3.1.0)
+## [3.1.2](https://github.com/sds100/KeyMapper/releases/tag/v3.1.2)
 
 #### TO BE RELEASED
 
 ## Added
 
+- #1466 show onboarding when creating a key map for the first time
+
+## Changed
+
+- #1701 improve the order of the actions and categories
+
+## Bug fixes
+
+- #1686 (more fixes) do not show some screens behind system bars on the left/right side of the device.
+- #1701 optimize the trigger screen for smaller screens so elements are less cut off.
+- #1699 Do not highlight a floating button as if it is pressed after triggering a key event action from it.
+
+## [3.1.1](https://github.com/sds100/KeyMapper/releases/tag/v3.1.1)
+
+#### 12 May 2025
+
+## Added
+
+- #1637 show a home screen error if notification permission is not granted.
+- #1435 Pick system sounds/ringtones for the Sound action.
+
+## Bug fixes
+
+- Do not automatically select the key mapper keyboard when the accessibility service starts.
+- #1686 do not show some screens behind system bars on the left/right side of the device.
+- Use same sized list items when choosing a constraint.
+
+## [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

CREDITS.md

@@ -8,11 +8,12 @@ Many thanks to...
  - [App Mockup] for their screenshot utility.
  - Airbnb for their [Epoxy](https://github.com/airbnb/epoxy) RecyclerView. They made having multiple itemview types and dragging and dropping super easy!
  - @[Jake Wharton](https://github.com/JakeWharton) for his [Timber](https://github.com/JakeWharton/timber) logging library.
- - @[AppIntro](https://github.com/AppIntro) for their [AppIntro](https://github.com/AppIntro/AppIntro) library.
  - @[srikanth-lingala](https://github.com/srikanth-lingala) for their Java zip file [library](https://github.com/srikanth-lingala/zip4j).
  - @[anggrayudi](https://github.com/anggrayudi) for their [Simple Storage](https://github.com/anggrayudi/SimpleStorage) library that makes working with Scoped Storage and the Storage Access Framework on Android much easier.
  - @[MFlisar](https://github.com/MFlisar) for their [drag and select](https://github.com/MFlisar/DragSelectRecyclerView) library.
  - @[RikkaApps](https://github.com/RikkaApps) for Shizuku! It is amazing.
+ - @[canopas](https://github.com/canopas) for their Jetpack Compose Tap Target library https://github.com/canopas/compose-intro-showcase.
+ - @[topjohnwu](https://github.com/topjohnwu) for Magisk and [libsu](https://github.com/topjohnwu/libsu).
 
 [salomonbrys]: https://github.com/salomonbrys
 [Kotson]: https://github.com/salomonbrys/Kotson

app/build.gradle

@@ -162,12 +162,14 @@ android {
 
 dependencies {
     implementation fileTree(include: ["*.jar"], dir: "libs")
+    implementation project(':nativelib')
+    implementation project(':privstarter')
 
     compileOnly project(":systemstubs")
 
     def room_version = "2.7.1"
     def coroutinesVersion = "1.9.0"
-    def nav_version = '2.8.9'
+    def nav_version = '2.9.0'
     def epoxy_version = "4.6.2"
     def splitties_version = "3.0.0"
     def multidex_version = "2.0.1"
@@ -192,10 +194,12 @@ 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.17.0'
+    proImplementation 'com.revenuecat.purchases:purchases:8.17.1'
     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")
+    implementation 'com.canopas.intro-showcase-view:introshowcaseview:2.0.2'
+    implementation "com.github.topjohnwu.libsu:core:6.0.0"
 
     // splitties
     implementation "com.louiscad.splitties:splitties-bitflags:$splitties_version"
@@ -211,9 +215,9 @@ dependencies {
 
     implementation "androidx.activity:activity-ktx:1.10.1"
     implementation "androidx.fragment:fragment-ktx:1.8.6"
-    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.8.7"
-    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.8.7"
-    implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.8.7"
+    implementation "androidx.lifecycle:lifecycle-viewmodel-ktx:2.9.0"
+    implementation "androidx.lifecycle:lifecycle-runtime-ktx:2.9.0"
+    implementation "androidx.lifecycle:lifecycle-livedata-ktx:2.9.0"
     implementation "androidx.room:room-ktx:$room_version"
     implementation "androidx.navigation:navigation-fragment-ktx:$nav_version"
     implementation "androidx.navigation:navigation-ui-ktx:$nav_version"
@@ -225,15 +229,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"
+    implementation "androidx.navigation:navigation-compose:2.9.0"
+    implementation "androidx.navigation:navigation-fragment-compose:2.9.0"
     ksp "androidx.room:room-compiler:$room_version"
 
     // Compose
-    Dependency composeBom = platform('androidx.compose:compose-bom-beta:2025.04.01')
+    Dependency composeBom = platform('androidx.compose:compose-bom-beta:2025.05.00')
     implementation composeBom
     implementation 'androidx.compose.foundation:foundation'
     implementation "androidx.compose.ui:ui-android"