voltra 1.2.0 → 1.3.0-rc.1

package/README.md

@@ -24,14 +24,18 @@ Voltra turns React Native JSX into SwiftUI and Jetpack Compose Glance so you can
 
 The documentation is available at [use-voltra.dev](https://use-voltra.dev). You can also use the following links to jump to specific topics:
 
-- [Quick Start](https://use-voltra.dev/getting-started/quick-start)
-- [Development](https://www.use-voltra.dev/development/developing-live-activities)
-- [Components](https://www.use-voltra.dev/components/overview)
-- [API Reference](https://use-voltra.dev/api/configuration)
+- [Getting Started](https://use-voltra.dev/getting-started/introduction)
+- [Installation](https://use-voltra.dev/getting-started/installation)
+- [iOS Setup](https://use-voltra.dev/ios/setup)
+- [Android Setup](https://use-voltra.dev/android/setup)
+- [iOS Development](https://use-voltra.dev/ios/development/developing-live-activities)
+- [Android Development](https://use-voltra.dev/android/development/developing-widgets)
+- [iOS API Reference](https://use-voltra.dev/ios/api/configuration)
+- [Android API Reference](https://use-voltra.dev/android/api/plugin-configuration)
 
 ## Getting started
 
-> [!NOTE]  
+> [!NOTE]
 > The library isn't supported in Expo Go. To set it up correctly, you need to use [Expo Dev Client](https://docs.expo.dev/versions/latest/sdk/dev-client/).
 
 Install the package:
@@ -52,7 +56,7 @@ Add the config plugin to your `app.json`:
 
 Then run `npx expo prebuild --clean` to generate the native extension targets.
 
-See the [documentation](https://use-voltra.dev/getting-started/quick-start) for detailed setup instructions.
+See the [documentation](https://use-voltra.dev/getting-started/installation) for detailed setup instructions.
 
 ## Quick example
 
@@ -90,7 +94,7 @@ Voltra is a cross-platform library that supports:
 
 ## Authors
 
-`voltra` is an open source collaboration between [Saúl Sharma](https://github.com/saul-sharma) and [Szymon Chmal](https://github.com/szymonchmal) at [Callstack][callstack-readme-with-love].
+`voltra` is an open source collaboration between [Saúl Sharma](https://github.com/saulsharma) and [Szymon Chmal](https://github.com/szymonchmal) at [Callstack][callstack-readme-with-love].
 
 If you think it's cool, please star it 🌟. This project will always remain free to use.
 

package/android/build.gradle

@@ -51,11 +51,20 @@ if (useManagedAndroidSdkVersions) {
   }
 }
 
+// Read version from package.json for BuildConfig
+def packageJsonFile = new File(project.projectDir.parentFile, "package.json")
+def packageJson = new groovy.json.JsonSlurper().parseText(packageJsonFile.text)
+def voltraVersion = packageJson.version
+
 android {
   namespace "voltra"
   defaultConfig {
     versionCode 1
     versionName "0.1.0"
+    buildConfigField "String", "VOLTRA_VERSION", "\"${voltraVersion}\""
+  }
+  buildFeatures {
+    buildConfig true
   }
   lintOptions {
     abortOnError false
@@ -63,6 +72,17 @@ android {
   buildFeatures {
     compose true
   }
+  testOptions {
+    unitTests.all {
+      testLogging {
+        events "passed", "failed", "skipped"
+        exceptionFormat "full"
+        showCauses true
+        showExceptions true
+        showStackTraces true
+      }
+    }
+  }
 }
 
 dependencies {
@@ -73,6 +93,15 @@ dependencies {
   // Compose runtime (required for Glance)
   api "androidx.compose.runtime:runtime:1.6.8"
 
+  // WorkManager (for periodic server-driven widget updates)
+  api "androidx.work:work-runtime-ktx:2.9.1"
+
+  // DataStore (credential storage for widget server updates)
+  api "androidx.datastore:datastore-preferences:1.1.4"
+
+  // Google Tink (encryption for credential storage)
+  implementation "com.google.crypto.tink:tink-android:1.19.0"
+
   // JSON parsing
   implementation "com.google.code.gson:gson:2.10.1"
 
@@ -81,4 +110,8 @@ dependencies {
 
   // Kotlinx Serialization
   implementation "org.jetbrains.kotlinx:kotlinx-serialization-json:1.6.3"
+
+  // Unit tests
+  testImplementation "junit:junit:4.13.2"
+  testImplementation "org.jetbrains.kotlinx:kotlinx-coroutines-test:1.8.1"
 }

package/android/src/main/java/voltra/VoltraModule.kt

@@ -328,6 +328,50 @@ class VoltraModule : Module() {
                 imageManager.clearPreloadedImages(keys)
             }
 
+            // Widget Server Credentials APIs
+
+            AsyncFunction("setWidgetServerCredentials") { credentials: Map<String, Any?> ->
+                Log.d(TAG, "setWidgetServerCredentials called")
+
+                val context = appContext.reactContext!!
+                val token =
+                    credentials["token"] as? String
+                        ?: throw IllegalArgumentException("token is required in credentials")
+
+                @Suppress("UNCHECKED_CAST")
+                val headers = credentials["headers"] as? Map<String, String>
+
+                runBlocking {
+                    voltra.widget.VoltraWidgetCredentialStore.saveToken(context, token)
+                    if (headers != null && headers.isNotEmpty()) {
+                        voltra.widget.VoltraWidgetCredentialStore.saveHeaders(context, headers)
+                    }
+                }
+
+                Log.d(TAG, "Widget server credentials saved")
+
+                val widgetManager = voltra.widget.VoltraWidgetManager(context)
+                runBlocking {
+                    widgetManager.reloadAllWidgets()
+                }
+            }
+
+            AsyncFunction("clearWidgetServerCredentials") {
+                Log.d(TAG, "clearWidgetServerCredentials called")
+
+                val context = appContext.reactContext!!
+                runBlocking {
+                    voltra.widget.VoltraWidgetCredentialStore.clearAll(context)
+                }
+
+                Log.d(TAG, "Widget server credentials cleared")
+
+                val widgetManager = voltra.widget.VoltraWidgetManager(context)
+                runBlocking {
+                    widgetManager.reloadAllWidgets()
+                }
+            }
+
             AsyncFunction("reloadLiveActivities") { activityNames: List<String>? ->
                 // On Android, we don't have "Live Activities" in the same sense as iOS,
                 // but we might want to refresh widgets or notifications.

package/android/src/main/java/voltra/VoltraRN.kt

@@ -60,6 +60,10 @@ class VoltraRN(
         val widthDp = frameLayout.width.toFloat() / density
         val heightDp = frameLayout.height.toFloat() / density
 
+        // Don't render until we have real dimensions from layout.
+        // onLayout() will call updateView() once dimensions are available.
+        if (widthDp <= 1f || heightDp <= 1f) return
+
         // Avoid redundant updates if nothing significant changed and we already have a view
         if (frameLayout.childCount > 0 &&
             payloadStr == lastRenderedPayload &&
@@ -94,14 +98,7 @@ class VoltraRN(
                         return@launch
                     }
 
-                    // Determine size for Glance composition.
-                    // Glance needs a non-zero size. If we don't have one yet, use a fallback.
-                    val composeSize =
-                        if (widthDp > 1f && heightDp > 1f) {
-                            DpSize(widthDp.dp, heightDp.dp)
-                        } else {
-                            DpSize(300.dp, 200.dp)
-                        }
+                    val composeSize = DpSize(widthDp.dp, heightDp.dp)
 
                     val glanceRemoteViews = GlanceRemoteViews()
                     val factory = GlanceFactory(id, voltraPayload.e, voltraPayload.s)
@@ -117,19 +114,27 @@ class VoltraRN(
 
                     val remoteViews = result.remoteViews
 
+                    // Check if the frameLayout dimensions have changed since we started composing.
+                    // If so, skip this render — a new updateView() will be triggered by onLayout.
+                    val currentWidthDp = frameLayout.width.toFloat() / density
+                    val currentHeightDp = frameLayout.height.toFloat() / density
+                    if (abs(currentWidthDp - widthDp) >= 1.0f || abs(currentHeightDp - heightDp) >= 1.0f) {
+                        return@launch
+                    }
+
                     withContext(Dispatchers.Main) {
                         try {
-                            // Try to reapply to the existing view first to avoid flickering/replacing
+                            // Try to reapply to the existing view first to avoid flickering/replacing.
+                            // IMPORTANT: Only use reapply for dimension-only changes (same payload).
+                            // When the payload changes, always do a fresh apply to prevent stale
+                            // style bleed (e.g. padding from a previous widget persisting because
+                            // the new widget's RemoteViews doesn't explicitly reset it to zero).
                             var applied = false
-                            if (frameLayout.childCount > 0) {
+                            if (frameLayout.childCount > 0 && payloadStr == lastRenderedPayload) {
                                 try {
                                     val existingView = frameLayout.getChildAt(0)
                                     remoteViews.reapply(context, existingView)
                                     applied = true
-                                    // Update tracking state
-                                    lastRenderedPayload = payloadStr
-                                    lastRenderedWidthDp = widthDp
-                                    lastRenderedHeightDp = heightDp
                                 } catch (e: Exception) {
                                 }
                             }
@@ -145,25 +150,29 @@ class VoltraRN(
                                 if (childCount > 1) {
                                     frameLayout.removeViews(0, childCount - 1)
                                 }
-
-                                // CRITICAL FIX: Manually trigger layout for the new content.
-                                // Since we are adding this async, the parent won't do it for us automatically.
-                                frameLayout.measure(
-                                    View.MeasureSpec.makeMeasureSpec(frameLayout.width, View.MeasureSpec.EXACTLY),
-                                    View.MeasureSpec.makeMeasureSpec(frameLayout.height, View.MeasureSpec.EXACTLY),
-                                )
-                                frameLayout.layout(
-                                    frameLayout.left,
-                                    frameLayout.top,
-                                    frameLayout.right,
-                                    frameLayout.bottom,
-                                )
-
-                                // Update tracking state
-                                lastRenderedPayload = payloadStr
-                                lastRenderedWidthDp = widthDp
-                                lastRenderedHeightDp = heightDp
                             }
+
+                            // Always re-measure and re-layout after applying RemoteViews.
+                            // This is critical because:
+                            // 1) After fresh inflate: the view was added asynchronously so the parent
+                            //    won't trigger layout automatically.
+                            // 2) After reapply: text content or styles may have changed, requiring
+                            //    re-measurement to avoid stale layout constraints (e.g. truncated text).
+                            frameLayout.measure(
+                                View.MeasureSpec.makeMeasureSpec(frameLayout.width, View.MeasureSpec.EXACTLY),
+                                View.MeasureSpec.makeMeasureSpec(frameLayout.height, View.MeasureSpec.EXACTLY),
+                            )
+                            frameLayout.layout(
+                                frameLayout.left,
+                                frameLayout.top,
+                                frameLayout.right,
+                                frameLayout.bottom,
+                            )
+
+                            // Update tracking state
+                            lastRenderedPayload = payloadStr
+                            lastRenderedWidthDp = widthDp
+                            lastRenderedHeightDp = heightDp
                         } catch (e: Exception) {
                         }
                     }

package/android/src/main/java/voltra/generated/ShortNames.kt

@@ -67,6 +67,7 @@ object ShortNames {
             "fvar" to "fontVariant",
             "fw" to "fontWeight",
             "fgs" to "foregroundStyle",
+            "fss" to "foregroundStyleScale",
             "f" to "frame",
             "g" to "gap",
             "gs" to "gaugeStyle",
@@ -83,6 +84,7 @@ object ShortNames {
             "ly" to "layout",
             "lp" to "layoutPriority",
             "l" to "left",
+            "lgv" to "legendVisibility",
             "ls" to "letterSpacing",
             "lh" to "lineHeight",
             "ll" to "lineLimit",
@@ -95,6 +97,7 @@ object ShortNames {
             "mr" to "marginRight",
             "mt" to "marginTop",
             "mv" to "marginVertical",
+            "mrk" to "marks",
             "me" to "maskElement",
             "maxh" to "maxHeight",
             "max" to "maximumValue",
@@ -163,6 +166,10 @@ object ShortNames {
             "valig" to "verticalAlignment",
             "wt" to "weight",
             "w" to "width",
+            "xgs" to "xAxisGridStyle",
+            "xav" to "xAxisVisibility",
+            "ygs" to "yAxisGridStyle",
+            "yav" to "yAxisVisibility",
             "zi" to "zIndex",
         )