Add image conversion script and update build configurations

- Introduced a new script `convert_images_to_gif.py` for converting PNG images to an animated GIF.
- Updated `build_publish.yml` to allow the publish step to continue on error.
- Updated Gradle wrapper to version 8.14.1 and Kotlin to version 2.1.21.
- Modified AndroidManifest.xml and other files for improved theme handling and navigation.
- Added preview functions for various composables to enhance UI testing.

Author: softartdev

.github/workflows/build_publish.yml

@@ -29,4 +29,5 @@ jobs:
       - name: Build
         run: ./gradlew build
       - name: Publish
+        continue-on-error: true
         run: ./gradlew publishAllPublicationsToSonatypeRepository --max-workers 1 closeAndReleaseRepository

README.md

@@ -9,25 +9,52 @@ Supported platforms:
 - iOS
 - Desktop JVM (MacOS, Linux, Windows)
 
-![Android screenshot](screenshots/android.gif)
-![Desktop screenshot](screenshots/desktop.gif)
+![Android screenshot](doc/screenshots/gif/android/material_design_3/demo.gif)
+![iOS screenshot](doc/screenshots/gif/iOS/material_design_3/demo.gif)
+![Desktop screenshot](doc/screenshots/gif/desktop/material_design_3/demo.gif)
+<details>
+    <summary>More…</summary>
+    <p><img src="doc/screenshots/gif/android/material_design_2/demo.gif"> <img src="doc/screenshots/gif/iOS/material_design_2/demo.gif"> <img src="doc/screenshots/gif/desktop/material_design_2/demo.gif"></p>
+</details>
 
 ## Usage
-Call composable functions for material theme wrap, preferences items on settings screen, showing dialog for select theme.
+Call composable functions to wrap your app, show theme preference items, and handle dialog state manually.
+
+**Show dialog directly:**
+Use `ThemeAlertDialog` to show a dialog with theme preferences:
 ```kotlin
 @Composable
-fun App() = PreferableMaterialTheme { // provides composition locals
-    SettingsScaffold { // includes TopAppBar
-        Box {
-            Column {
-                ThemePreferencesCategory() // subtitle
-                ThemePreferenceItem() // menu item
-            }
-            themePrefs.showDialogIfNeed() // shows when menu item clicked
+fun App() = PreferableMaterialTheme {
+    var showDialog by remember { mutableStateOf(false) }
+    SettingsScaffold(onThemeClick = { showDialog = true }) {
+        Column {
+            ThemePreferencesCategory() // subtitle
+            ThemePreferenceItem(onClick = { showDialog = true }) // menu item
         }
     }
+    if (showDialog) {
+        ThemeAlertDialog(dismissDialog = { showDialog = false })
+    }
 }
 ```
+**With navigation frameworks:**
+Use `ThemeDialogContent` as the content of a dialog destination:
+```kotlin
+@Composable
+fun App() = PreferableMaterialTheme {
+    val navController = rememberNavController()
+    NavHost(navController = navController) {
+        composable<AppNavGraph.Settings> {
+            SettingsBody(onThemeClick = { navController.navigate(route = AppNavGraph.ThemeDialog) })
+        }
+        dialog<AppNavGraph.ThemeDialog> {
+            ThemeDialogContent(dismissDialog = navController::popBackStack)
+        }
+    }
+}
+```
+Check the [sample app](sample/src/commonMain/kotlin/com/softartdev/shared/App.kt) for using with Material Design versions 2 & 3.
+
 The [NoteDelight](https://github.com/softartdev/NoteDelight/blob/master/shared-compose-ui/src/commonMain/kotlin/com/softartdev/notedelight/ui/SettingsScreen.kt#L104) app is a real example.   
 ## Installation
 The latest release is available on [Maven Central](https://repo1.maven.org/maven2/io/github/softartdev/theme-material/).
@@ -49,7 +76,7 @@ commonMain {
 }
 ```
 ## Implementation
-Used [moko-resources](https://github.com/icerockdev/moko-resources) library for many languages (currently Russian and English are supported).
+Used [compose-multiplatform-resources](https://www.jetbrains.com/help/kotlin-multiplatform-dev/compose-multiplatform-resources.html) library for many languages (currently Russian and English are supported).
 
 Persisting preferences is implemented using [SharedPreferences](https://developer.android.com/reference/android/content/SharedPreferences) on Android, and [Java Preference API](https://docs.oracle.com/javase/7/docs/api/java/util/prefs/Preferences.html) on JVM Desktop.
 ```kotlin
@@ -69,6 +96,13 @@ private var preferences: Preferences = Preferences.userNodeForPackage(ThemeEnum:
 actual var themeEnum: ThemeEnum
     get() = preferences.getInt(THEME_KEY, ThemeEnum.SystemDefault.ordinal).let(ThemeEnum.values()::get)
     set(value) = preferences.putInt(THEME_KEY, value.ordinal)
+
+// ios:
+private val preferences: NSUserDefaults = NSUserDefaults.standardUserDefaults
+
+actual var themeEnum: ThemeEnum
+    get() = preferences.integerForKey(THEME_KEY).let(ThemeEnum.values()::get)
+    set(value) = preferences.setInteger(value.ordinal, THEME_KEY)
 ```
 Also used [composition local](https://developer.android.com/jetpack/compose/compositionlocal) for access from theme-scoped as an implicit way:
 ```kotlin

build.gradle.kts

@@ -1,7 +1,7 @@
 buildscript {
-    extra["kotlin_version"] = "2.1.20"
+    extra["kotlin_version"] = "2.1.21"
     extra["android_min_sdk_version"] = 21
-    extra["android_compile_sdk_version"] = 35
+    extra["android_compile_sdk_version"] = 36
     extra["jdk_version"] = 17
     repositories {
         gradlePluginPortal()
@@ -11,8 +11,9 @@ buildscript {
     dependencies {
         classpath("org.jetbrains.kotlin:kotlin-gradle-plugin:${rootProject.extra["kotlin_version"]}")
         classpath("org.jetbrains.kotlin:compose-compiler-gradle-plugin:${rootProject.extra["kotlin_version"]}")
-        classpath("com.android.tools.build:gradle:8.9.1")
-        classpath("org.jetbrains.compose:compose-gradle-plugin:1.8.0-beta01")
+        classpath("com.android.tools.build:gradle:8.10.1")
+        classpath("org.jetbrains.compose:compose-gradle-plugin:1.8.1")
+        classpath("org.jetbrains.kotlin:kotlin-serialization:${rootProject.extra["kotlin_version"]}")
     }
 }
 allprojects {

doc/claude.md

@@ -0,0 +1,67 @@
+#!/usr/bin/env python3
+"""
+convert_images_to_gif.py
+
+This script takes all PNG files in the current directory, sorts them alphabetically,
+resizes each image to a fixed height (default 500px), and combines them into a single
+animated GIF called 'demo.gif', displaying each frame for 1 second (1 fps).
+"""
+
+import os
+from PIL import Image
+
+# -----------------------------------------------------------------------------
+# CONSTANTS
+# -----------------------------------------------------------------------------
+# Height of the resulting GIF, in pixels (maintains aspect ratio for width)
+HEIGHT = 500
+
+# Name of the output GIF file
+OUTPUT_GIF = "demo.gif"
+
+# File extension filter (only PNG files in this example)
+EXTENSION = ".png"
+
+
+def main():
+    # 1) List all files with the specified extension in the current directory
+    files = [fname for fname in os.listdir(".") if fname.lower().endswith(EXTENSION)]
+    files.sort()  # Sort alphabetically
+
+    if not files:
+        print(f"No '{EXTENSION}' files found in the current directory.")
+        return
+
+    frames = []
+    for fname in files:
+        # 2) Open each image
+        img = Image.open(fname)
+
+        # 3) Resize to the specified HEIGHT, maintaining aspect ratio
+        original_width, original_height = img.size
+        new_height = HEIGHT
+        new_width = int(original_width * new_height / original_height)
+        img_resized = img.resize((new_width, new_height), Image.LANCZOS)
+
+        # 4) Convert to paletted ("P") mode for GIF compatibility
+        frames.append(img_resized.convert("P", palette=Image.ADAPTIVE))
+
+    # 5) Save frames as an animated GIF
+    #    - duration=1000ms per frame (1 second)
+    #    - loop=0 (infinite loop)
+    try:
+        frames[0].save(
+            OUTPUT_GIF,
+            format="GIF",
+            save_all=True,
+            append_images=frames[1:],
+            duration=1000,  # milliseconds per frame
+            loop=0
+        )
+        print(f"Saved GIF as '{OUTPUT_GIF}'.")
+    except Exception as e:
+        print(f"Error while saving GIF: {e}")
+
+
+if __name__ == "__main__":
+    main()