WIP: local changes before rebase

Author: mat-in

docs/MIGRATION.md

@@ -7,9 +7,9 @@ to your `putString().commit()` or `getInt()` usage.
 
 ## What changes?
 
-### Setup
+### Dagger Setup Example
 
-If you're using **Dagger**, you only need to change this:
+If you're using **Dagger**:
 
 ```kotlin
 @Singleton
@@ -29,7 +29,7 @@ fun provideEncryptedSharedPreferences(context: Context): SharedPreferences {
 }
 ```
 
-to this (SafeBox):
+### To this (SafeBox):
 
 ```kotlin
 @Singleton
@@ -38,30 +38,48 @@ fun provideEncryptedSharedPreferences(context: Context): SharedPreferences =
     SafeBox.create(context, PREF_FILE_NAME)
 ```
 
-Or if you're using **Koin**:
+No changes to the rest of your code.
+
+### Koin Setup Example
+
+If you're using **Koin**, the migration is just as seamless:
 
 ```kotlin
 single<SharedPreferences> {
     SafeBox.create(androidContext(), PREF_FILE_NAME)
 }
 ```
 
-### Existing Data Migration
+## Using Singleton Access (Optional)
 
-If your app already stores data in `EncryptedSharedPreferences` or even plain `SharedPreferences`, you can migrate them into SafeBox with one line:
+For apps that prefer a **singleton-style instance**, SafeBox provides `SafeBoxProvider`, which can be initialized once and accessed anywhere.
+
+### Initialization (in `Application` class)
 
 ```kotlin
-SafeBoxMigrationHelper.migrate(from = encryptedPrefs, to = safeBox)
+class MyApp : Application() {
+    override fun onCreate() {
+        super.onCreate()
+
+        SafeBoxProvider.init(
+            context = this,
+            fileName = PREF_FILE_NAME
+        )
+    }
+}
 ```
 
-✅ This helper is available in version 1.1.0-alpha01:
+### Usage (Anywhere in your app)
 
 ```kotlin
-dependencies {
-    implementation("io.github.harrytmthy-dev:safebox:1.1.0-alpha01")
-}
+val prefs = SafeBoxProvider.get()
+val name = prefs.getString("name", null)
 ```
 
+> You can still call `SafeBox.create(...)` directly if you prefer not to use a singleton.
+
+---
+
 ## Still unsure?
 
 - SafeBox is open-source and MIT licensed

safebox/src/main/java/com/harrytmthy/safebox/SafeBox.kt

@@ -328,10 +328,6 @@ public class SafeBox private constructor(
          */
         @JvmOverloads
         @JvmStatic
-        @Deprecated(
-            message = "Use SafeBoxProvider.init(...) and SafeBoxProvider.get() instead.",
-            replaceWith = ReplaceWith("SafeBoxProvider.get()"),
-        )
         public fun create(
             context: Context,
             fileName: String,
@@ -372,10 +368,6 @@ public class SafeBox private constructor(
          */
         @JvmOverloads
         @JvmStatic
-        @Deprecated(
-            message = "Use SafeBoxProvider.init(...) and SafeBoxProvider.get() instead.",
-            replaceWith = ReplaceWith("SafeBoxProvider.get()"),
-        )
         public fun create(
             context: Context,
             fileName: String,