Reimplemented the whole passcode handeling logic implemented and the ability to change passcode. (#56)

* Refactor passcode management and introduce `PasscodeManager`

*   Introduced `PasscodeManager`, `PasscodeStorageAdapter`, and `PasscodeAction` to provide a more robust state management system for passcode operations.
*   Renamed `PasscodeEvent` to `PasscodeEvents` and `PasscodeState` to `PasscodeStates` to avoid naming collisions with new manager components.
*   Added a `Change` step to the passcode utility and updated `PasscodeHeader` to support the change passcode flow.
*   Updated `PasscodeSaver` with `resetPasscode` functionality and renamed callback parameters for clarity (`saveNewPasscode`, `clearCurrentPasscode`).
*   Modified `SampleAppNavigation` and `HomeScreen` to support the "Change Passcode" feature.
*   Added `.claude` to `.gitignore`.
*   Imported `VisibilityOff` icon for use in passcode components.

* Refactor passcode management and UI configuration

* Replaced `PasscodeSaver` and `PasscodeRepository` with a new `PasscodeManager` and `PasscodeStorageAdapter` for improved state handling and persistence.
* Replaced custom `PreferenceDataStore` with `com.russhwolf.settings.Settings` throughout the shared module.
* Introduced `PasscodeScreenConfig.kt` containing data classes (`PasscodeAppearanceConfig`, `PasscodeLogoConfig`, etc.) to provide granular styling control for the passcode screen.
* Updated `PasscodeScreen` to use the new configuration classes and collect state from `PasscodeManager` via `collectAsStateWithLifecycle`.
* Refactored `PasscodeStep` and related logic to support a clearer state machine (Unset, Enter, Create, Confirm, ChangeVerify).
* Updated `SampleAppNavigation` and `HomeScreen` to integrate with the new `PasscodeManager` and action-based event handling.
* Removed unused components and files, including `PasscodeRepository.kt` and `PreferenceDataStore.kt`.
* Improved `PasscodeHeader` and button components to respond to the new `PasscodeStep` architecture.

* Clean up passcode logic and refactor build configurations

*   Removed deprecated `PasscodeSaver.kt` and `Step.kt` in favor of the new `PasscodeManager` implementation.
*   Updated `PasscodeScreen.kt` to handle `PasscodeEvent` updates and improved code formatting.
*   Commented out `PasscodeStepIndicator` and `PasscodeToolbar` pending compatibility fixes with the new passcode logic.
*   Added copyright headers and improved formatting in `PasscodeStorageAdapterImpl.kt` and `PasscodeManager.kt`.
*   Standardized trailing commas and whitespace across multiple files in `cmp-sample-shared`.
*   Removed unused imports in `PasscodeScreenConfig.kt`, `PasscodeHeader.kt`, and `SampleAppNavigation.kt`.

* Update passcode change flow and state management

*   Added `confirm_old_passcode` string resource and integrated it into `PasscodeHeader` for the `ChangeVerify` step.
*   Implemented unique animation transitions (offset, alpha, and scale) for the `ChangeVerify` header in `PasscodeHeader`.
*   Renamed `clearState` to `clearStates` in `PasscodeManager` and ensured consistent calls across passcode handling methods.
*   Fixed passcode builder logic in `PasscodeManager` to properly clear `creationPasscodeBuilder` and `finalConfirmationPasscodeBuilder` during the creation and verification flows.
*   Updated `handleChangeVerifyPasscode` to transition to the `Create` step upon successful verification of the old passcode.

* Update .gitignore and PULL_REQUEST_TEMPLATE.md

* Removed `.claude` from `.gitignore`.
* Removed Jira ticket references and links from `PULL_REQUEST_TEMPLATE.md`.
* Updated the static analysis check instructions in the PR template to remove the reference to `ci-prepush.sh`.

Author: TheKalpeshPawar

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,7 +1,3 @@
-Fixes - [Jira-#Issue_Number](https://mifosforge.jira.com/browse/MIFOSAC-)
-
-Didn't create a Jira ticket, click [here](https://mifosforge.jira.com/jira/software/c/projects/MIFOSAC/issues/) to create new.
-
 Please Add Screenshots If there are any UI changes.
 
 | Before                                     | After                                  |
@@ -10,6 +6,6 @@ Please Add Screenshots If there are any UI changes.
 
 Please make sure these boxes are checked before submitting your pull request - thanks!
 
-- [ ] Run the static analysis check `./gradlew check` or `ci-prepush.sh` to make sure you didn't break anything
+- [ ] Run the static analysis check `./gradlew check` to make sure you didn't break anything
 
 - [ ] If you have multiple commits please combine them into one commit by squashing them.

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/App.kt

@@ -13,32 +13,31 @@ import androidx.compose.material3.MaterialTheme
 import androidx.compose.runtime.Composable
 import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionRepository
 import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionScreenViewmodel
-import cmp.sample.shared.kmpDataStore.PreferenceDataStoreImpl
 import cmp.sample.shared.navigation.SampleAppNavigation
-import cmp.sample.shared.passcode.PasscodeRepository
 import cmp.sample.shared.platformAuthentication.AuthenticationScreenViewModel
+import com.russhwolf.settings.Settings
 import org.mifos.authenticator.biometrics.LibraryLocalCompositionProvider
 
 @Composable
 fun App() {
     LibraryLocalCompositionProvider {
         MaterialTheme {
-            val kmpDataStore = PreferenceDataStoreImpl()
+            val settings = Settings()
 
-            val chooseAuthOptionRepository = ChooseAuthOptionRepository(kmpDataStore)
+            val chooseAuthOptionRepository = ChooseAuthOptionRepository(settings)
             val chooseAuthOptionScreenViewmodel = ChooseAuthOptionScreenViewmodel(
                 chooseAuthOptionRepository,
             )
 
             val platformAuthOptionScreenViewmodel = AuthenticationScreenViewModel(
                 chooseAuthOptionRepository = chooseAuthOptionRepository,
-                preferenceDataStore = kmpDataStore,
+                settings = settings,
             )
 
-            val passcodeRepository = PasscodeRepository(kmpDataStore)
+            val passcodeStorageAdapter = PasscodeStorageAdapterImpl(settings)
 
             SampleAppNavigation(
-                passcodeRepository,
+                passcodeStorageAdapter,
                 chooseAuthOptionScreenViewmodel,
                 platformAuthOptionScreenViewmodel,
             )

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/PasscodeStorageAdapterImpl.kt

@@ -0,0 +1,31 @@
+/*
+ * Copyright 2026 Mifos Initiative
+ *
+ * This Source Code Form is subject to the terms of the Mozilla Public
+ * License, v. 2.0. If a copy of the MPL was not distributed with this
+ * file, You can obtain one at https://mozilla.org/MPL/2.0/.
+ *
+ * See https://github.com/openMF/mifos-passcode-cmp/blob/development/LICENSE
+ */
+package cmp.sample.shared
+
+import com.russhwolf.settings.Settings
+import org.mifos.authenticator.passcode.PasscodeStorageAdapter
+
+const val PASSCODE_KEY = "org.mifos.authenticator.passcode"
+
+class PasscodeStorageAdapterImpl(
+    private val settings: Settings,
+) : PasscodeStorageAdapter {
+    override fun savePasscode(passcode: String) {
+        settings.putString(PASSCODE_KEY, passcode)
+    }
+
+    override fun loadPasscode(): String? {
+        return settings.getStringOrNull(PASSCODE_KEY)
+    }
+
+    override fun deletePasscode() {
+        settings.remove(PASSCODE_KEY)
+    }
+}

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/chooseAuthOption/ChooseAuthOptionRepository.kt

@@ -10,42 +10,42 @@
 package cmp.sample.shared.chooseAuthOption
 
 import cmp.sample.shared.chooseAuthOption.utils.Helpers
-import cmp.sample.shared.kmpDataStore.PreferenceDataStore
+import com.russhwolf.settings.Settings
 
 const val APP_LOCK_KEY = "auth_method"
 const val REGISTRATION_DATA = "REGISTRATION_DATA"
 
 class ChooseAuthOptionRepository(
-    private val preferenceDataStore: PreferenceDataStore,
+    private val settings: Settings,
 ) {
 
     fun setAuthOption(option: AppLockOption) {
-        preferenceDataStore.putData(
+        settings.putString(
             APP_LOCK_KEY,
             Helpers.authOptionToStringMapperFunction(option),
         )
     }
 
     fun getAuthOption(): AppLockOption {
         return Helpers.stringToAuthOptionMapperFunction(
-            preferenceDataStore.getSavedData(
+            settings.getString(
                 APP_LOCK_KEY,
                 "",
             ),
         )
     }
 
     fun clearAuthOption() {
-        preferenceDataStore.clearData(APP_LOCK_KEY)
+        settings.remove(APP_LOCK_KEY)
     }
 
     fun saveRegistrationData(registrationData: String) {
-        preferenceDataStore.putData(REGISTRATION_DATA, registrationData)
+        settings.putString(REGISTRATION_DATA, registrationData)
     }
 
-    fun getRegistrationData() = preferenceDataStore.getSavedData(REGISTRATION_DATA, "")
+    fun getRegistrationData() = settings.getString(REGISTRATION_DATA, "")
 
     fun clearRegistrationData() {
-        preferenceDataStore.clearData(REGISTRATION_DATA)
+        settings.remove(REGISTRATION_DATA)
     }
 }

cmp-sample-shared/src/commonMain/kotlin/cmp/sample/shared/kmpDataStore/PreferenceDataStore.kt

@@ -20,8 +20,7 @@ import androidx.compose.runtime.Composable
 import androidx.compose.runtime.getValue
 import androidx.compose.runtime.mutableStateOf
 import androidx.compose.runtime.remember
-import androidx.compose.runtime.saveable.rememberSaveable
-import androidx.compose.runtime.setValue
+import androidx.compose.runtime.rememberCoroutineScope
 import androidx.compose.ui.Alignment
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.text.font.FontWeight
@@ -33,55 +32,42 @@ import androidx.navigation.compose.rememberNavController
 import cmp.sample.shared.chooseAuthOption.AppLockOption
 import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionScreen
 import cmp.sample.shared.chooseAuthOption.ChooseAuthOptionScreenViewmodel
-import cmp.sample.shared.passcode.PasscodeRepository
 import cmp.sample.shared.platformAuthentication.AuthenticationScreen
 import cmp.sample.shared.platformAuthentication.AuthenticationScreenViewModel
 import org.mifos.authenticator.biometrics.Platform
 import org.mifos.authenticator.biometrics.getPlatform
-import org.mifos.authenticator.passcode.rememberPasscodeSaver
+import org.mifos.authenticator.passcode.PasscodeAction
+import org.mifos.authenticator.passcode.PasscodeStorageAdapter
+import org.mifos.authenticator.passcode.rememberPasscodeManager
 import org.mifos.authenticator.passcode.screen.PasscodeScreen
 
 @Composable
 fun SampleAppNavigation(
-    passcodeRepository: PasscodeRepository,
+    passcodeStorageAdapter: PasscodeStorageAdapter,
     chooseAuthOptionScreenViewmodel: ChooseAuthOptionScreenViewmodel,
     platformAuthOptionScreenViewmodel: AuthenticationScreenViewModel,
 ) {
     val navController = rememberNavController()
 
     val currentAppLock = chooseAuthOptionScreenViewmodel.getAppLock()
 
-    var isPasscodeSet by rememberSaveable {
-        mutableStateOf(passcodeRepository.isPasscodeSet())
-    }
-    var savedPasscode by rememberSaveable {
-        mutableStateOf(passcodeRepository.getPasscode())
-    }
+    val scope = rememberCoroutineScope()
 
-    val passcodeSaver = rememberPasscodeSaver(
-        currentPasscode = savedPasscode,
-        isPasscodeSet = isPasscodeSet,
-        savePasscode = { passcode ->
-            passcodeRepository.savePasscode(passcode)
-        },
-        clearPasscode = {
-            passcodeRepository.clearPasscode()
-        },
-        currentPasscodeLength = passcodeRepository.getPasscodeLength(),
-        savePasscodeLength = { passcodeLength ->
-            passcodeRepository.savePasscodeLength(passcodeLength.length)
-        },
+    val passcodeManager = rememberPasscodeManager(
+        passcodeStorageAdapter,
+        scope,
     )
 
+    val isUsingPasscode = !passcodeStorageAdapter.loadPasscode().isNullOrBlank()
+
     val startDestination by remember {
         mutableStateOf(
             when (currentAppLock) {
                 AppLockOption.MifosPasscode -> {
-                    if (passcodeRepository.isPasscodeSet()) {
+                    if (isUsingPasscode) {
                         Route.PasscodeScreen
                     } else {
                         chooseAuthOptionScreenViewmodel.clearAppLock()
-                        passcodeRepository.clearPasscodeLength()
                         Route.LoginScreen
                     }
                 }
@@ -115,20 +101,14 @@ fun SampleAppNavigation(
 
         composable<Route.PasscodeScreen> {
             PasscodeScreen(
-                passcodeSaver = passcodeSaver,
+                passcodeManager = passcodeManager,
                 onPasscodeConfirm = {
-                    passcodeRepository.savePasscode(
-                        it,
-                    )
                     navController.popBackStack()
                     navController.navigate(Route.HomeScreen) {
                         popUpTo(0)
                     }
                 },
                 onForgotButton = {
-                    passcodeSaver.forgetPasscode()
-                    savedPasscode = passcodeRepository.getPasscode()
-                    isPasscodeSet = passcodeRepository.isPasscodeSet()
                     navController.navigate(Route.LoginScreen) {
                         popUpTo(0)
                     }
@@ -139,6 +119,13 @@ fun SampleAppNavigation(
                         popUpTo(0)
                     }
                 },
+                onPasscodeCreation = {
+                    navController.popBackStack()
+                    navController.navigate(Route.HomeScreen) {
+                        popUpTo(0)
+                    }
+                },
+                onPasscodeRejected = {},
             )
         }
 
@@ -149,16 +136,21 @@ fun SampleAppNavigation(
         }
 
         composable<Route.HomeScreen> {
-            HomeScreen {
-                chooseAuthOptionScreenViewmodel.clearAppLock()
-                chooseAuthOptionScreenViewmodel.clearRegistrationData()
-                passcodeSaver.forgetPasscode()
-                savedPasscode = passcodeRepository.getPasscode()
-                isPasscodeSet = passcodeRepository.isPasscodeSet()
-                navController.navigate(Route.LoginScreen) {
-                    popUpTo(0)
-                }
-            }
+            HomeScreen(
+                usingPasscode = !passcodeStorageAdapter.loadPasscode().isNullOrBlank(),
+                onLogoutClick = {
+                    chooseAuthOptionScreenViewmodel.clearAppLock()
+                    chooseAuthOptionScreenViewmodel.clearRegistrationData()
+                    passcodeManager.trySendAction(PasscodeAction.DeletePasscode)
+                    navController.navigate(Route.LoginScreen) {
+                        popUpTo(0)
+                    }
+                },
+                changePasscode = {
+                    passcodeManager.trySendAction(PasscodeAction.ChangePasscode)
+                    navController.navigate(Route.PasscodeScreen)
+                },
+            )
         }
 
         composable<Route.DeviceAuthScreen> {
@@ -199,7 +191,9 @@ fun LoginScreen(
 
 @Composable
 fun HomeScreen(
+    usingPasscode: Boolean,
     onLogoutClick: () -> Unit,
+    changePasscode: () -> Unit,
 ) {
     Column(
         modifier = Modifier.fillMaxSize(),
@@ -222,5 +216,19 @@ fun HomeScreen(
                 "Log Out",
             )
         }
+
+        if (usingPasscode) {
+            Spacer(modifier = Modifier.height(20.dp))
+
+            Button(
+                onClick = {
+                    changePasscode()
+                },
+            ) {
+                Text(
+                    "Change Passcode",
+                )
+            }
+        }
     }
 }