@aguacerowx/react-native 0.0.4 → 0.0.7

package/README.md

@@ -1,16 +1,61 @@
+# @aguacerowx/react-native
+
+Welcome to the official React Native SDK for AguaceroWX.
+
 ## Installation
 ```bash
 npm install @aguacerowx/react-native
 ```
 
-### Android Setup
+### Important Prerequisite: Mapbox SDK v11
+
+This library is built on top of `@rnmapbox/maps` and requires the Mapbox Maps SDK v11 for both iOS and Android. You must perform the following manual setup steps to configure your project correctly.
+
+## iOS Setup
+
+You must explicitly enable Mapbox SDK v11 in your iOS project.
+
+### Modify your Podfile
+
+Open your project's `ios/Podfile` and add the following lines near the top of the file. This tells the `@rnmapbox/maps` library to use a v11 version of the native SDK.
+```ruby
+# Add these lines near the top of your ios/Podfile
+require_relative '../node_modules/@rnmapbox/maps/scripts/mapbox-rb'
+$RNMapboxMapsVersion = '~> 11.0' # This enforces Mapbox SDK v11
+use_mapbox_maps!
+```
+
+### Install Pods
+
+After saving the Podfile, navigate to your `ios` directory in the terminal and run a fresh pod installation.
+```bash
+cd ios
+pod install
+```
+
+## Android Setup
+
+Android requires configuration for Mapbox credentials and an additional native dependency.
+
+### Configure Mapbox Credentials
+
+You will need a secret token with `DOWNLOADS:READ` scope and a public token.
+
+In your `android/gradle.properties` file, add your secret token:
+```properties
+# android/gradle.properties
+MAPBOX_DOWNLOADS_TOKEN=sk.xxxxxxxxxx
+```
 
-Add the zstd-jni dependency to your `android/app/build.gradle`:
+In your `android/app/build.gradle` file, add your public token inside the `defaultConfig` block:
 ```groovy
-dependencies {
-    // ... your other dependencies
-    implementation 'com.github.luben:zstd-jni:1.5.7-6@aar'
+// android/app/build.gradle
+android {
+    defaultConfig {
+        // ... other configs
+        buildConfigField "String", "MAPBOX_ACCESS_TOKEN", "\"pk.xxxxxxxxxx\""
+    }
 }
 ```
 
-This dependency provides native compression support and is required for the library to function.
+After completing these steps, your application should be correctly configured to use the library. For more detailed information or troubleshooting, please refer to the official `@rnmapbox/maps` documentation.

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -1,4 +1,4 @@
-#Wed Nov 05 19:31:04 EST 2025
+#Wed Nov 12 11:54:27 EST 2025
 com.aguacerowx.reactnative.aguacerowx_react-native-main-6\:/raw/fragment_shader.glsl=C\:\\Users\\my41m\\aguacero\\ReactNativeApp\\node_modules\\@aguacerowx\\react-native\\android\\build\\intermediates\\packaged_res\\debug\\packageDebugResources\\raw\\fragment_shader.glsl
 com.aguacerowx.reactnative.aguacerowx_react-native-main-6\:/raw/debug_vertex_shader.glsl=C\:\\Users\\my41m\\aguacero\\ReactNativeApp\\node_modules\\@aguacerowx\\react-native\\android\\build\\intermediates\\packaged_res\\debug\\packageDebugResources\\raw\\debug_vertex_shader.glsl
 com.aguacerowx.reactnative.aguacerowx_react-native-main-6\:/raw/vertex_shader.glsl=C\:\\Users\\my41m\\aguacero\\ReactNativeApp\\node_modules\\@aguacerowx\\react-native\\android\\build\\intermediates\\packaged_res\\debug\\packageDebugResources\\raw\\vertex_shader.glsl

package/android/build/intermediates/packaged_res/debug/packageDebugResources/raw/fragment_shader.glsl

@@ -13,6 +13,10 @@ uniform vec2 u_data_range;
 uniform vec2 u_texture_size;
 uniform int u_smoothing;
 
+// --- START OF FIX: Add the new uniform ---
+uniform int u_scale_type; // 0 for linear, 1 for sqrt
+// --- END OF FIX ---
+
 // Custom bilinear filtering that respects NaN boundaries
 float sampleDataTextureSmooth(vec2 uv) {
     float missing_in_texture_range = u_missing_quantized + 128.0;
@@ -68,9 +72,16 @@ void main() {
         discard;
     }
 
-    // De-quantize the texture value to its actual physical value
+    // Step 1: Standard linear dequantization
     float quantized_value = value_in_texture - 128.0;
-    float raw_value = quantized_value * u_scale + u_offset;
+    float intermediate_value = quantized_value * u_scale + u_offset;
+    float raw_value = intermediate_value; // Default to linear
+
+    // Step 2: Apply non-linear inverse scaling if specified
+    if (u_scale_type == 1) { // 1 represents 'sqrt'
+        // Square the intermediate value while preserving its sign
+        raw_value = intermediate_value * abs(intermediate_value);
+    }
 
     // If the data is below the specified minimum range, make it invisible.
     if (raw_value < u_data_range.x) {

package/android/src/main/java/com/aguacerowx/reactnative/GridRenderLayer.java

@@ -32,7 +32,8 @@ public class GridRenderLayer implements CustomLayerHost {
 
     // Uniform and Attribute locations
     private int uMatrix, uDataTexture, uColormapTexture, uOpacity, uDataRange, 
-                uScale, uOffset, uMissingQuantized, uTextureSize, uConversionType, uSmoothing;  
+                uScale, uOffset, uMissingQuantized, uTextureSize, uConversionType, uSmoothing,
+                uScaleType;  
     private int aPosition, aTexCoord;
 
     // GPU-side resource IDs
@@ -52,13 +53,16 @@ public class GridRenderLayer implements CustomLayerHost {
     private int textureHeight = 0;
     private int conversionType = 0;
     private boolean smoothingEnabled = true;
+    private int scaleType = 0;
     private boolean textureParametersDirty = true; 
+    private volatile boolean isVisible = true;
 
     // Pending data buffers for thread-safe uploads
     private final Object dataLock = new Object();
     private ByteBuffer pendingDataBuffer = null;
     private int pendingNx = 0, pendingNy = 0;
     private float pendingScale = 1.0f, pendingOffset = 0.0f, pendingMissing = 127.0f;
+    private int pendingScaleType = 0;
     private ByteBuffer pendingColormapBuffer = null;
     private FloatBuffer pendingVertexBuffer = null;
     private ShortBuffer pendingIndexBuffer = null;
@@ -115,13 +119,22 @@ public class GridRenderLayer implements CustomLayerHost {
         uTextureSize = GLES20.glGetUniformLocation(program, "u_texture_size");
         uConversionType = GLES20.glGetUniformLocation(program, "u_conversion_type");
         uSmoothing = GLES20.glGetUniformLocation(program, "u_smoothing"); 
+        uScaleType = GLES20.glGetUniformLocation(program, "u_scale_type");
         aPosition = GLES20.glGetAttribLocation(program, "a_position");
         aTexCoord = GLES20.glGetAttribLocation(program, "a_texCoord");
     }
 
+    public void clearData() {
+        this.isVisible = false;
+        // Also clear any pending data to prevent a stale frame from rendering
+        synchronized (dataLock) {
+            pendingDataBuffer = null;
+        }
+    }
+
     @Override
     public void render(CustomLayerRenderParameters renderParameters) {
-        if (program == 0) return;
+        if (program == 0 || !isVisible) return;
 
         synchronized (dataLock) {
             if (pendingVertexBuffer != null && pendingIndexBuffer != null) {
@@ -149,6 +162,7 @@ public class GridRenderLayer implements CustomLayerHost {
                 this.scale = pendingScale;
                 this.offset = pendingOffset;
                 this.missingQuantized = pendingMissing;
+                this.scaleType = pendingScaleType;
                 
                 if (dataTextureId == 0) {
                     int[] t = new int[1];
@@ -228,6 +242,7 @@ public class GridRenderLayer implements CustomLayerHost {
         GLES20.glUniform2f(uTextureSize, (float) textureWidth, (float) textureHeight);
         GLES20.glUniform1i(uConversionType, conversionType);
         GLES20.glUniform1i(uSmoothing, smoothingEnabled ? 1 : 0); 
+        GLES20.glUniform1i(uScaleType, this.scaleType);
 
         GLES20.glActiveTexture(GLES20.GL_TEXTURE0);
         GLES20.glBindTexture(GLES20.GL_TEXTURE_2D, dataTextureId);
@@ -281,58 +296,9 @@ public class GridRenderLayer implements CustomLayerHost {
             this.textureParametersDirty = true;
         }
     }
-    
-    public void updateDataTextureFromFile(String filePath, int nx, int ny, float scale, float offset, float missing) {
-        Log.d(TAG, "Starting texture update from file: " + filePath);
-        
-        // This whole block runs on a background thread thanks to React Native,
-        // so file I/O and decompression are safe here.
-        File file = new File(filePath);
-        if (!file.exists()) {
-            Log.e(TAG, "File not found for texture update: " + filePath);
-            return;
-        }
-
-        try (FileInputStream fis = new FileInputStream(file)) {
-            // 1. Read the compressed file into a byte array
-            byte[] compressedData = new byte[(int) file.length()];
-            fis.read(compressedData);
-
-            // 2. Decompress using the zstd-jni library
-            // NOTE: The decompressed size needs to be known. We assume it's the grid size.
-            // If your encoding is different, you may need to adjust this.
-            long decompressedSize = (long) nx * ny;
-            byte[] decompressedDeltas = Zstd.decompress(compressedData, (int) decompressedSize);
-
-            // 3. Reconstruct delta-encoded data (Ported from your AguaceroCore.js)
-            byte[] reconstructedData = new byte[decompressedDeltas.length];
-            if (decompressedDeltas.length > 0) {
-                // First value is absolute
-                reconstructedData[0] = decompressedDeltas[0];
-                // Subsequent values are deltas
-                for (int i = 1; i < decompressedDeltas.length; i++) {
-                    reconstructedData[i] = (byte) (reconstructedData[i - 1] + decompressedDeltas[i]);
-                }
-            }
-            
-            // 4. Transform for GPU texture format (signed to unsigned)
-            byte[] textureData = new byte[reconstructedData.length];
-            for (int i = 0; i < reconstructedData.length; i++) {
-                textureData[i] = (byte) (reconstructedData[i] + 128);
-            }
-
-            // 5. Queue the final data for OpenGL using your existing thread-safe mechanism
-            updateDataTexture(textureData, nx, ny, scale, offset, missing);
-            Log.d(TAG, "Successfully queued texture data from file: " + filePath);
-
-        } catch (IOException e) {
-            Log.e(TAG, "Failed to read or decompress file: " + filePath, e);
-        }
-    }
-
 
     // This existing method is now used by both the old JS path and our new native path
-    public void updateDataTexture(byte[] bytes, int nx, int ny, float scale, float offset, float missing) {
+    public void updateDataTexture(byte[] bytes, int nx, int ny, float scale, float offset, float missing, String scaleType) {
         ByteBuffer dataBuffer = ByteBuffer.allocateDirect(bytes.length);
         dataBuffer.put(bytes);
         dataBuffer.position(0);
@@ -343,7 +309,10 @@ public class GridRenderLayer implements CustomLayerHost {
             this.pendingScale = scale;
             this.pendingOffset = offset;
             this.pendingMissing = missing;
+            this.pendingScaleType = "sqrt".equals(scaleType) ? 1 : 0;
         }
+        // When new data is provided, ensure the layer is visible
+        this.isVisible = true; 
     }
     
     public void updateColormapTexture(ByteBuffer data) {

package/android/src/main/java/com/aguacerowx/reactnative/GridRenderLayerView.java

@@ -38,13 +38,18 @@ public class GridRenderLayerView extends FrameLayout {
     private static float lastDataScale = 1.0f;
     private static float lastDataOffset = 0.0f;
     private static float lastDataMissing = 127.0f;
+    private static String lastDataScaleType = "linear";
 
     public GridRenderLayerView(@NonNull ThemedReactContext context) {
         super(context);
         this.gridLayerImplementation = new GridRenderLayer(context);
     }
+
+    public static String getLastDataScaleType() {
+        return lastDataScaleType;
+    }
     
-    public void updateDataTexture(String dataFilePathOrBase64, int nx, int ny, float scale, float offset, float missing) {
+    public void updateDataTexture(String dataFilePathOrBase64, int nx, int ny, float scale, float offset, float missing, String scaleType) {
         if (dataFilePathOrBase64 == null) {
             Log.e(TAG, "❌ [View] Data from manager is null!");
             return;
@@ -78,8 +83,9 @@ public class GridRenderLayerView extends FrameLayout {
             lastDataScale = scale;
             lastDataOffset = offset;
             lastDataMissing = missing;
+            lastDataScaleType = scaleType; // FIX: Update the cached scaleType
 
-            gridLayerImplementation.updateDataTexture(finalTextureBytes, nx, ny, scale, offset, missing);
+            gridLayerImplementation.updateDataTexture(finalTextureBytes, nx, ny, scale, offset, missing, scaleType);
             triggerRepaint();
 
         } catch (Exception e) {
@@ -284,4 +290,9 @@ public class GridRenderLayerView extends FrameLayout {
         lastDataOffset = offset;
         lastDataMissing = missing;
     }
+
+    public void clearData() {
+        gridLayerImplementation.clearData();
+        triggerRepaint();
+    }
 }

package/android/src/main/java/com/aguacerowx/reactnative/GridRenderManager.java

@@ -8,6 +8,7 @@ import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.uimanager.SimpleViewManager;
 import com.facebook.react.uimanager.ThemedReactContext;
 import com.facebook.react.uimanager.annotations.ReactProp;
+import android.util.Log;
 
 import java.util.Map;
 import java.util.HashMap;
@@ -19,6 +20,7 @@ public class GridRenderManager extends SimpleViewManager<GridRenderLayerView> {
     private static final int COMMAND_UPDATE_COLORMAP_TEXTURE = 2;
     private static final int COMMAND_UPDATE_GEOMETRY = 3;
     private static final int COMMAND_UPDATE_DATA_PARAMETERS = 4;
+    private static final int COMMAND_CLEAR = 5;
 
     @NonNull
     @Override
@@ -65,22 +67,23 @@ public class GridRenderManager extends SimpleViewManager<GridRenderLayerView> {
         commands.put("updateColormapTexture", COMMAND_UPDATE_COLORMAP_TEXTURE);
         commands.put("updateGeometry", COMMAND_UPDATE_GEOMETRY);
         commands.put("updateDataParameters", COMMAND_UPDATE_DATA_PARAMETERS);
+        commands.put("clear", COMMAND_CLEAR);
         return commands;
     }
 
     @Override
     public void receiveCommand(@NonNull GridRenderLayerView view, int commandId, @Nullable ReadableArray args) {
         switch (commandId) {
-            case COMMAND_UPDATE_DATA_TEXTURE:
-                if (args != null && args.size() >= 5) {
-                    String data = args.getString(0);
-                    int nx = args.getInt(1);
-                    int ny = args.getInt(2);
-                    float scale = (float) args.getDouble(3);
-                    float offset = (float) args.getDouble(4);
-                    float missing = args.size() > 5 ? (float) args.getDouble(5) : 127.0f;
-                    view.updateDataTexture(data, nx, ny, scale, offset, missing);
-                }
+            case COMMAND_UPDATE_DATA_TEXTURE:    
+                String data = args.getString(0);
+                int nx = args.getInt(1);
+                int ny = args.getInt(2);
+                float scale = (float) args.getDouble(3);
+                float offset = (float) args.getDouble(4);
+                float missing = (float) args.getDouble(5);
+                String scaleType = args.getString(6);
+
+                view.updateDataTexture(data, nx, ny, scale, offset, missing, scaleType);
                 break;
 
             case COMMAND_UPDATE_COLORMAP_TEXTURE:
@@ -100,12 +103,16 @@ public class GridRenderManager extends SimpleViewManager<GridRenderLayerView> {
 
             case COMMAND_UPDATE_DATA_PARAMETERS:
                 if (args != null && args.size() >= 3) {
-                    float scale = (float) args.getDouble(0);
-                    float offset = (float) args.getDouble(1);
-                    float missing = (float) args.getDouble(2);
-                    view.updateDataParameters(scale, offset, missing);
+                    float scaleParam = (float) args.getDouble(0);
+                    float offsetParam = (float) args.getDouble(1);
+                    float missingParam = (float) args.getDouble(2);
+                    view.updateDataParameters(scaleParam, offsetParam, missingParam);
                 }
                 break;
+
+            case COMMAND_CLEAR:
+                view.clearData();
+                break;
         }
     }
 }

package/android/src/main/java/com/aguacerowx/reactnative/WeatherFrameProcessorModule.java

@@ -13,6 +13,7 @@ import com.facebook.react.bridge.ReactMethod;
 import com.facebook.react.bridge.ReadableMap;
 import com.facebook.react.bridge.WritableMap;
 import com.facebook.react.modules.network.OkHttpClientProvider; 
+import android.util.Log;
 
 import org.json.JSONObject;
 
@@ -108,9 +109,20 @@ public class WeatherFrameProcessorModule extends ReactContextBaseJavaModule {
 
                 // The rest of your logic remains the same
                 JSONObject jsonResponse = new JSONObject(responseString);
+                if (!jsonResponse.has("data") || !jsonResponse.has("encoding")) {
+                    // If the core keys are missing, the response is invalid. Log it and fail.
+                    throw new IOException("Invalid API response. 'data' or 'encoding' key is missing. Response: " + responseString);
+                }
+
                 String b64CompressedData = jsonResponse.getString("data");
                 JSONObject encoding = jsonResponse.getJSONObject("encoding");
 
+
+                if (!encoding.has("scale") || !encoding.has("offset") || !encoding.has("missing_quantized")) {
+                    // If the encoding object is missing required values, fail with a clear error.
+                    throw new IOException("Invalid 'encoding' object in API response. Required keys are missing. Response: " + responseString);
+                }
+
                 byte[] compressedData = Base64.decode(b64CompressedData, Base64.DEFAULT);
 
                 File cacheDir = reactContext.getCacheDir();
@@ -128,6 +140,9 @@ public class WeatherFrameProcessorModule extends ReactContextBaseJavaModule {
                 responseMap.putDouble("scale", encoding.getDouble("scale"));
                 responseMap.putDouble("offset", encoding.getDouble("offset"));
                 responseMap.putDouble("missing", encoding.getDouble("missing_quantized"));
+                if (encoding.has("scale_type")) {
+                    responseMap.putString("scaleType", encoding.getString("scale_type"));
+                }
                 responseMap.putString("dataAsBase64", b64CompressedData);
 
                 callback.invoke(null, responseMap);

package/android/src/main/res/raw/fragment_shader.glsl

@@ -13,6 +13,10 @@ uniform vec2 u_data_range;
 uniform vec2 u_texture_size;
 uniform int u_smoothing;
 
+// --- START OF FIX: Add the new uniform ---
+uniform int u_scale_type; // 0 for linear, 1 for sqrt
+// --- END OF FIX ---
+
 // Custom bilinear filtering that respects NaN boundaries
 float sampleDataTextureSmooth(vec2 uv) {
     float missing_in_texture_range = u_missing_quantized + 128.0;
@@ -68,9 +72,16 @@ void main() {
         discard;
     }
 
-    // De-quantize the texture value to its actual physical value
+    // Step 1: Standard linear dequantization
     float quantized_value = value_in_texture - 128.0;
-    float raw_value = quantized_value * u_scale + u_offset;
+    float intermediate_value = quantized_value * u_scale + u_offset;
+    float raw_value = intermediate_value; // Default to linear
+
+    // Step 2: Apply non-linear inverse scaling if specified
+    if (u_scale_type == 1) { // 1 represents 'sqrt'
+        // Square the intermediate value while preserving its sign
+        raw_value = intermediate_value * abs(intermediate_value);
+    }
 
     // If the data is below the specified minimum range, make it invisible.
     if (raw_value < u_data_range.x) {

package/ios/GridRenderLayer.swift

@@ -0,0 +1,62 @@
+// packages/react-native/ios/GridRenderLayer.swift
+
+import Foundation
+import UIKit
+
+// The class must be `public` to be visible outside of the SDK module.
+// `@objc` exposes this class to the Objective-C runtime.
+@objc(GridRenderLayer)
+public class GridRenderLayer: UIView {
+
+  // ---- Properties ----
+  // These properties must also be `@objc public` so the React Native
+  // framework can set them from the props defined in the manager.
+  @objc public var opacity: Float = 1.0
+  @objc public var dataRange: NSArray = []
+  @objc public var belowID: NSString = ""
+  @objc public var smoothing: Bool = true
+
+  // ---- Initializers ----
+  override public init(frame: CGRect) {
+    super.init(frame: frame)
+    // For testing, make the view highly visible to confirm it has rendered.
+    self.backgroundColor = UIColor.systemTeal
+  }
+
+  required public init?(coder: NSCoder) {
+    fatalError("init(coder:) has not been implemented")
+  }
+
+  // ---- Custom Methods ----
+  // These are the functions that will be called by the Objective-C++ Manager.
+  // They must be `public` and exposed to Objective-C with `@objc`.
+  //
+  // NOTE: Objective-C will see this Swift function:
+  // func updateGeometry(corners: [String: Any], gridDef: [String: Any])
+  // as this Objective-C selector:
+  // - (void)updateGeometryWithCorners:(NSDictionary *)corners gridDef:(NSDictionary *)gridDef;
+
+  @objc
+  public func updateGeometry(corners: [String: Any], gridDef: [String: Any]) {
+      NSLog("[AguaceroSDK] Swift: updateGeometry called successfully.")
+      // Your actual rendering logic goes here.
+  }
+
+  @objc
+  public func updateDataTexture(data: String, nx: NSNumber, ny: NSNumber, scale: NSNumber, offset: NSNumber, missing: NSNumber) {
+      NSLog("[AguaceroSDK] Swift: updateDataTexture called successfully.")
+      // Your actual rendering logic goes here.
+  }
+
+  @objc
+  public func updateColormapTexture(colormapAsBase64: String) {
+      NSLog("[AguaceroSDK] Swift: updateColormapTexture called successfully.")
+      // Your actual rendering logic goes here.
+  }
+
+  @objc
+  public func updateDataParameters(scale: NSNumber, offset: NSNumber, missing: NSNumber) {
+      NSLog("[AguaceroSDK] Swift: updateDataParameters called successfully.")
+      // Your actual rendering logic goes here.
+  }
+}