expo-image 2.3.2 → 2.4.0-canary-20250709-136b77f

package/CHANGELOG.md

@@ -6,17 +6,27 @@
 
 ### 🎉 New features
 
+- Add support for `ImageRef` source in `generateBlurhashAsync` ([#37901](https://github.com/expo/expo/pull/37901) by [@Wenszel](https://github.com/Wenszel))
+- [Android] Add generateBlurhashAsync ([#37817](https://github.com/expo/expo/pull/37817) by [@Wenszel](https://github.com/Wenszel))
+- [iOS] Add a new prop - `enforceEarlyResizing` to reduce the memory usage of the image view. ([#37909](https://github.com/expo/expo/pull/37909) by [@lukmccall](https://github.com/lukmccall))
+
 ### 🐛 Bug fixes
 
+- [iOS] Speed up displaying local assets. ([#37795](https://github.com/expo/expo/pull/37795) by [@aleqsio](https://github.com/aleqsio))
+- [Android] Fix animation resuming by casting image to GifDrawable. ([#37363](https://github.com/expo/expo/pull/37363) by [@Wenszel](https://github.com/Wenszel))
+- [Web] Fix `alt` as an alias for `accessibilityLabel` ([#37682](https://github.com/expo/expo/pull/37682) by [@huextrat](https://github.com/huextrat))
+
 ### 💡 Others
 
-## 2.3.2 — 2025-07-01
+### 📚 3rd party library updates
+
+## 2.3.2 - 2025-07-01
 
 ### 🐛 Bug fixes
 
 - [iOS] Use specified cache type when no transformation is applied ([#37777](https://github.com/expo/expo/pull/37777) by [@jakex7](https://github.com/jakex7))
 
-## 2.3.1 — 2025-07-01
+## 2.3.1 - 2025-07-01
 
 ### 🐛 Bug fixes
 
@@ -26,17 +36,21 @@
 
 - [Android] Bumped GIF Glide plugin to 3.0.5 for Android 16KB page size support. ([#37454](https://github.com/expo/expo/pull/37454) by [@kudo](https://github.com/kudo))
 
-## 2.3.0 — 2025-06-11
+## 2.3.0 - 2025-06-11
 
 ### 🛠 Breaking changes
 
 - [iOS] `useAppleWebpCodec` has been moved from the source object to the component's prop to make it usable with the local assets. ([#37300](https://github.com/expo/expo/pull/37300) by [@tsapeta](https://github.com/tsapeta))
 
-## 2.2.1 — 2025-06-10
+### 🐛 Bug fixes
+
+- [iOS] Fix blurry images when using `tintColor` by scaling `imageThumbnailPixelSize` with screen density. ([#37235](https://github.com/expo/expo/pull/37235) by [@hirbod](https://github.com/hirbod))
+
+## 2.2.1 - 2025-06-10
 
 _This version does not introduce any user-facing changes._
 
-## 2.2.0 — 2025-06-04
+## 2.2.0 - 2025-06-04
 
 ### 🎉 New features
 
@@ -47,7 +61,7 @@ _This version does not introduce any user-facing changes._
 - Fix React Server Components support. ([#36801](https://github.com/expo/expo/pull/36801) by [@EvanBacon](https://github.com/EvanBacon))
 - [iOS] Fix PhotoLibrary assets being scaled twice. ([#36776](https://github.com/expo/expo/pull/36776) by [@alanjhughes](https://github.com/alanjhughes))
 - [iOS] Don't add transformers when unnecessary. ([#36884](https://github.com/expo/expo/pull/36884) by [@jakex7](https://github.com/jakex7))
-- [iOS] Fix blurry images when using `tintColor` by scaling `imageThumbnailPixelSize` with screen density. ([#37235](https://github.com/expo/expo/pull/37235) by [@hirbod](https://github.com/hirbod))
+- [Web] Fix `tintColor` in React 19. ([#37133](https://github.com/expo/expo/pull/37133) by [@bradleyayers](https://github.com/bradleyayers))
 
 ## 2.1.7 — 2025-05-06
 

package/android/build.gradle

@@ -8,7 +8,7 @@ android {
   namespace "expo.modules.image"
   defaultConfig {
     versionCode 1
-    versionName "2.3.2"
+    versionName "2.4.0-canary-20250709-136b77f"
     consumerProguardFiles("proguard-rules.pro")
 
     buildConfigField("boolean", "ALLOW_GLIDE_LOGS", project.properties.get("EXPO_ALLOW_GLIDE_LOGS", "false"))

package/android/src/main/java/expo/modules/image/ExpoImageModule.kt

@@ -5,6 +5,7 @@ package expo.modules.image
 import android.graphics.Bitmap
 import android.graphics.drawable.BitmapDrawable
 import android.graphics.drawable.Drawable
+import androidx.core.graphics.drawable.toBitmap
 import androidx.core.graphics.drawable.toBitmapOrNull
 import androidx.core.view.doOnDetach
 import com.bumptech.glide.Glide
@@ -19,6 +20,7 @@ import com.bumptech.glide.request.target.Target
 import com.github.penfeizhou.animation.apng.APNGDrawable
 import com.github.penfeizhou.animation.gif.GifDrawable
 import com.github.penfeizhou.animation.webp.WebPDrawable
+import expo.modules.image.blurhash.BlurhashEncoder
 import expo.modules.image.enums.ContentFit
 import expo.modules.image.enums.Priority
 import expo.modules.image.records.CachePolicy
@@ -36,8 +38,12 @@ import expo.modules.kotlin.functions.Queues
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
 import expo.modules.kotlin.sharedobjects.SharedRef
+import expo.modules.kotlin.types.Either
 import expo.modules.kotlin.types.EitherOfThree
 import expo.modules.kotlin.types.toKClass
+import kotlinx.coroutines.Dispatchers
+import kotlinx.coroutines.withContext
+import java.net.URL
 
 class ExpoImageModule : Module() {
   override fun definition() = ModuleDefinition {
@@ -112,6 +118,20 @@ class ExpoImageModule : Module() {
       ImageLoadTask(appContext, source, options ?: ImageLoadOptions()).load()
     }
 
+    AsyncFunction("generateBlurhashAsync") Coroutine { source: Either<URL, Image>, numberOfComponents: Pair<Int, Int> ->
+      val image = source.let {
+        if (it.`is`(Image::class)) {
+          it.get(Image::class)
+        } else {
+          ImageLoadTask(appContext, SourceMap(uri = it.get(URL::class).toString()), ImageLoadOptions()).load()
+        }
+      }
+      val blurHash = withContext(Dispatchers.Default) {
+        BlurhashEncoder.encode(image.ref.toBitmap(), numberOfComponents)
+      }
+      blurHash
+    }
+
     Class(Image::class) {
       Property("width") { image: Image ->
         image.ref.intrinsicWidth

package/android/src/main/java/expo/modules/image/ExpoImageViewWrapper.kt

@@ -18,6 +18,7 @@ import com.bumptech.glide.RequestManager
 import com.bumptech.glide.load.engine.DiskCacheStrategy
 import com.bumptech.glide.load.resource.bitmap.DownsampleStrategy
 import com.bumptech.glide.request.RequestOptions
+import com.github.penfeizhou.animation.gif.GifDrawable
 import expo.modules.image.enums.ContentFit
 import expo.modules.image.enums.Priority
 import expo.modules.image.events.GlideRequestListener
@@ -169,14 +170,32 @@ class ExpoImageViewWrapper(context: Context, appContext: AppContext) : ExpoView(
   internal var cachePolicy: CachePolicy = CachePolicy.DISK
 
   fun setIsAnimating(setAnimating: Boolean) {
-    val resource = activeView.drawable
+    // Animatable animations always start from the beginning when resumed.
+    // So we check first if the resource is a GifDrawable, because it can continue
+    // from where it was paused.
+    when (val resource = activeView.drawable) {
+      is GifDrawable -> setIsAnimating(resource, setAnimating)
+      is Animatable -> setIsAnimating(resource, setAnimating)
+    }
+  }
 
-    if (resource is Animatable) {
-      if (setAnimating) {
-        resource.start()
+  private fun setIsAnimating(resource: GifDrawable, setAnimating: Boolean) {
+    if (setAnimating) {
+      if (resource.isPaused) {
+        resource.resume()
       } else {
-        resource.stop()
+        resource.start()
       }
+    } else {
+      resource.pause()
+    }
+  }
+
+  private fun setIsAnimating(resource: Animatable, setAnimating: Boolean) {
+    if (setAnimating) {
+      resource.start()
+    } else {
+      resource.stop()
     }
   }
 

package/android/src/main/java/expo/modules/image/blurhash/BlurhashDecoder.kt

@@ -74,16 +74,7 @@ object BlurhashDecoder {
     val r = colorEnc shr 16
     val g = (colorEnc shr 8) and 255
     val b = colorEnc and 255
-    return floatArrayOf(srgbToLinear(r), srgbToLinear(g), srgbToLinear(b))
-  }
-
-  private fun srgbToLinear(colorEnc: Int): Float {
-    val v = colorEnc / 255f
-    return if (v <= 0.04045f) {
-      (v / 12.92f)
-    } else {
-      ((v + 0.055f) / 1.055f).pow(2.4f)
-    }
+    return floatArrayOf(BlurhashHelpers.srgbToLinear(r), BlurhashHelpers.srgbToLinear(g), BlurhashHelpers.srgbToLinear(b))
   }
 
   private fun decodeAc(value: Int, maxAc: Float): FloatArray {

package/android/src/main/java/expo/modules/image/blurhash/BlurhashEncoder.kt

@@ -0,0 +1,112 @@
+package expo.modules.image.blurhash
+
+import android.graphics.Bitmap
+import android.graphics.Color
+import kotlin.math.*
+
+/**
+ * Rewritten in kotlin from https://github.com/woltapp/blurhash/blob/master/Swift/BlurHashEncode.swift
+ */
+object BlurhashEncoder {
+  fun encode(image: Bitmap, numberOfComponents: Pair<Int, Int>): String {
+    val pixels = IntArray(image.width * image.height)
+    image.getPixels(pixels, 0, image.width, 0, 0, image.width, image.height)
+
+    val factors = calculateBlurFactors(pixels, image.width, image.height, numberOfComponents)
+
+    val dc = factors.first()
+    val ac = factors.drop(1)
+    val hashBuilder = StringBuilder()
+
+    encodeFlag(numberOfComponents, hashBuilder)
+    val maximumValue = encodeMaximumValue(ac, hashBuilder)
+    hashBuilder.append(encode83(encodeDC(dc), 4))
+    for (factor in ac) {
+      hashBuilder.append(encode83(encodeAC(factor, maximumValue), 2))
+    }
+
+    return hashBuilder.toString()
+  }
+
+  private fun encodeFlag(numberOfComponents: Pair<Int, Int>, hashBuilder: StringBuilder) {
+    val sizeFlag = (numberOfComponents.first - 1) + (numberOfComponents.second - 1) * 9
+    hashBuilder.append(encode83(sizeFlag, 1))
+  }
+
+  private fun encodeMaximumValue(ac: List<Triple<Float, Float, Float>>, hash: StringBuilder): Float {
+    val maximumValue: Float
+    if (ac.isNotEmpty()) {
+      val actualMaximumValue = ac.maxOf { t -> max(max(abs(t.first), abs(t.second)), abs(t.third)) }
+      val quantisedMaximumValue = max(0f, min(82f, floor(actualMaximumValue * 166f - 0.5f))).toInt()
+      maximumValue = (quantisedMaximumValue + 1).toFloat() / 166f
+      hash.append(encode83(quantisedMaximumValue, 1))
+    } else {
+      maximumValue = 1f
+      hash.append(encode83(0, 1))
+    }
+    return maximumValue
+  }
+
+  private fun calculateBlurFactors(pixels: IntArray, width: Int, height: Int, numberOfComponents: Pair<Int, Int>): List<Triple<Float, Float, Float>> {
+    val factors = mutableListOf<Triple<Float, Float, Float>>()
+    for (y in 0 until numberOfComponents.second) {
+      for (x in 0 until numberOfComponents.first) {
+        val normalisation = if (x == 0 && y == 0) 1f else 2f
+        val factor = multiplyBasisFunction(pixels, width, height, x, y, normalisation)
+        factors.add(factor)
+      }
+    }
+    return factors
+  }
+
+  private fun encode83(value: Int, length: Int): String {
+    var result = ""
+    for (i in 1..length) {
+      val digit = (value / 83f.pow((length - i).toFloat())) % 83f
+      result += ENCODE_CHARACTERS[digit.toInt()]
+    }
+    return result
+  }
+
+  private const val ENCODE_CHARACTERS =
+    "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz#$%*+,-.:;=?@[]^_{|}~"
+
+  private fun encodeDC(value: Triple<Float, Float, Float>): Int {
+    val roundedR = BlurhashHelpers.linearTosRGB(value.first)
+    val roundedG = BlurhashHelpers.linearTosRGB(value.second)
+    val roundedB = BlurhashHelpers.linearTosRGB(value.third)
+    return (roundedR shl 16) + (roundedG shl 8) + roundedB
+  }
+
+  private fun encodeAC(value: Triple<Float, Float, Float>, maximumValue: Float): Int {
+    val quantR = max(0f, min(18f, floor(BlurhashHelpers.signPow(value.first / maximumValue, 0.5f) * 9f + 9.5f)))
+    val quantG = max(0f, min(18f, floor(BlurhashHelpers.signPow(value.second / maximumValue, 0.5f) * 9f + 9.5f)))
+    val quantB = max(0f, min(18f, floor(BlurhashHelpers.signPow(value.third / maximumValue, 0.5f) * 9f + 9.5f)))
+
+    return (quantR * 19f * 19f + quantG * 19f + quantB).toInt()
+  }
+
+  private fun multiplyBasisFunction(pixels: IntArray, width: Int, height: Int, x: Int, y: Int, normalisation: Float): Triple<Float, Float, Float> {
+    var r = 0f
+    var g = 0f
+    var b = 0f
+
+    for (j in 0 until height) {
+      for (i in 0 until width) {
+        val basis = normalisation * cos(PI.toFloat() * x * i / width) * cos(PI.toFloat() * y * j / height)
+
+        val pixel = pixels[i + j * width]
+        val pr = BlurhashHelpers.srgbToLinear(Color.red(pixel))
+        val pg = BlurhashHelpers.srgbToLinear(Color.green(pixel))
+        val pb = BlurhashHelpers.srgbToLinear(Color.blue(pixel))
+
+        r += basis * pr
+        g += basis * pg
+        b += basis * pb
+      }
+    }
+
+    val scale = 1f / (width * height)
+    return Triple(r * scale, g * scale, b * scale)
+  }
+}

package/android/src/main/java/expo/modules/image/blurhash/BlurhashHelpers.kt

@@ -0,0 +1,38 @@
+package expo.modules.image.blurhash
+
+import android.graphics.Bitmap
+import kotlin.math.*
+
+object BlurhashHelpers {
+  fun srgbToLinear(colorEnc: Int): Float {
+    val v = colorEnc / 255f
+    return if (v <= 0.04045f) {
+      (v / 12.92f)
+    } else {
+      ((v + 0.055f) / 1.055f).pow(2.4f)
+    }
+  }
+
+  fun linearTosRGB(value: Float): Int {
+    val v = max(0f, min(1f, value))
+    return if (v <= 0.0031308) {
+      (v * 12.92 * 255 + 0.5).toInt()
+    } else {
+      (1.055 * (v.pow(1f / 2.4f) - 0.055) * 255 + 0.5).toInt()
+    }
+  }
+
+  fun signPow(value: Float, exp: Float): Float {
+    return abs(value).pow(exp) * sign(value)
+  }
+
+  fun getBitsPerPixel(bitmap: Bitmap): Int {
+    return when (bitmap.config) {
+      Bitmap.Config.ARGB_8888 -> 32
+      Bitmap.Config.RGB_565 -> 16
+      Bitmap.Config.ALPHA_8 -> 8
+      Bitmap.Config.ARGB_4444 -> 16
+      else -> 0
+    }
+  }
+}

package/android/src/main/java/expo/modules/image/okhttp/GlideUrlWrapperLoader.kt

@@ -28,7 +28,7 @@ class GlideUrlWrapperLoader(
             originalResponse
               .newBuilder()
               .body(
-                ProgressResponseBody(originalResponse.body) { bytesWritten, contentLength, done ->
+                ProgressResponseBody(requireNotNull(originalResponse.body)) { bytesWritten, contentLength, done ->
                   model.progressListener?.onProgress(bytesWritten, contentLength, done)
                 }
               )

package/build/ExpoImage.web.d.ts

@@ -1,4 +1,4 @@
 import React from 'react';
 import type { ImageNativeProps } from './Image.types';
-export default function ExpoImage({ source, placeholder, contentFit, contentPosition, placeholderContentFit, cachePolicy, onLoad, transition, onError, responsivePolicy, onLoadEnd, onDisplay, priority, blurRadius, recyclingKey, style, nativeViewRef, accessibilityLabel, tintColor, containerViewRef, ...props }: ImageNativeProps): React.JSX.Element;
+export default function ExpoImage({ source, placeholder, contentFit, contentPosition, placeholderContentFit, cachePolicy, onLoad, transition, onError, responsivePolicy, onLoadEnd, onDisplay, priority, blurRadius, recyclingKey, style, nativeViewRef, accessibilityLabel, alt, tintColor, containerViewRef, ...props }: ImageNativeProps): React.JSX.Element;
 //# sourceMappingURL=ExpoImage.web.d.ts.map

package/build/ExpoImage.web.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ExpoImage.web.d.ts","sourceRoot":"","sources":["../src/ExpoImage.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,gBAAgB,EAA6C,MAAM,eAAe,CAAC;AAsDjG,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,MAAM,EACN,WAAW,EACX,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,MAAM,EACN,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,KAAK,EACL,aAAa,EACb,kBAAkB,EAClB,SAAS,EACT,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,gBAAgB,qBA0FlB"}
+{"version":3,"file":"ExpoImage.web.d.ts","sourceRoot":"","sources":["../src/ExpoImage.web.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,OAAO,CAAC;AAI1B,OAAO,KAAK,EAAE,gBAAgB,EAA6C,MAAM,eAAe,CAAC;AAsDjG,MAAM,CAAC,OAAO,UAAU,SAAS,CAAC,EAChC,MAAM,EACN,WAAW,EACX,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,WAAW,EACX,MAAM,EACN,UAAU,EACV,OAAO,EACP,gBAAgB,EAChB,SAAS,EACT,SAAS,EACT,QAAQ,EACR,UAAU,EACV,YAAY,EACZ,KAAK,EACL,aAAa,EACb,kBAAkB,EAClB,GAAG,EACH,SAAS,EACT,gBAAgB,EAChB,GAAG,KAAK,EACT,EAAE,gBAAgB,qBA0FlB"}

package/build/Image.d.ts

@@ -66,13 +66,14 @@ export declare class Image extends React.PureComponent<ImageProps> {
     static getCachePathAsync(cacheKey: string): Promise<string | null>;
     /**
      * Asynchronously generates a [Blurhash](https://blurha.sh) from an image.
-     * @param url - The URL of the image to generate a blurhash from.
+     * @param source - The image source, either a URL (string) or an ImageRef
      * @param numberOfComponents - The number of components to encode the blurhash with.
      * Must be between 1 and 9. Defaults to `[4, 3]`.
+     * @platform android
      * @platform ios
      * @return A promise resolving to the blurhash string.
      */
-    static generateBlurhashAsync(url: string, numberOfComponents: [number, number] | {
+    static generateBlurhashAsync(source: string | ImageRef, numberOfComponents: [number, number] | {
         width: number;
         height: number;
     }): Promise<string | null>;

package/build/Image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../src/Image.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,WAAW,EACZ,MAAM,eAAe,CAAC;AAQvB,qBAAa,KAAM,SAAQ,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC;IACxD,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;gBAEnC,KAAK,EAAE,UAAU;IAO7B,gBAAgB,2BAMd;IAEF;;OAEG;IACH,MAAM,CAAC,KAAK,kBAAqB;IAEjC;;;;;;;;;;OAUG;WACU,QAAQ,CACnB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAChD,OAAO,CAAC,OAAO,CAAC;IACnB;;;;;;;;;;OAUG;WACU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBhG;;;;;;;OAOG;WACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjD;;;;;;;OAOG;WACU,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/C;;;;;;;;;OASG;WACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxE;;;;;;;OAOG;WACU,qBAAqB,CAChC,GAAG,EAAE,MAAM,EACX,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzB;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;OAMG;WACU,SAAS,CACpB,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,QAAQ,CAAC;IAKpB,MAAM;CA6CP"}
+{"version":3,"file":"Image.d.ts","sourceRoot":"","sources":["../src/Image.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAc,KAAK,IAAI,EAAE,MAAM,cAAc,CAAC;AAErD,OAAO,SAAS,MAAM,aAAa,CAAC;AACpC,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,QAAQ,EACR,WAAW,EACZ,MAAM,eAAe,CAAC;AAQvB,qBAAa,KAAM,SAAQ,KAAK,CAAC,aAAa,CAAC,UAAU,CAAC;IACxD,aAAa,EAAE,KAAK,CAAC,SAAS,CAAC,SAAS,GAAG,IAAI,CAAC,CAAC;IACjD,gBAAgB,EAAE,KAAK,CAAC,SAAS,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC;gBAEnC,KAAK,EAAE,UAAU;IAO7B,gBAAgB,2BAMd;IAEF;;OAEG;IACH,MAAM,CAAC,KAAK,kBAAqB;IAEjC;;;;;;;;;;OAUG;WACU,QAAQ,CACnB,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EACvB,WAAW,CAAC,EAAE,oBAAoB,CAAC,aAAa,CAAC,GAChD,OAAO,CAAC,OAAO,CAAC;IACnB;;;;;;;;;;OAUG;WACU,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBhG;;;;;;;OAOG;WACU,gBAAgB,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjD;;;;;;;OAOG;WACU,cAAc,IAAI,OAAO,CAAC,OAAO,CAAC;IAI/C;;;;;;;;;OASG;WACU,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIxE;;;;;;;;OAQG;WACU,qBAAqB,CAChC,MAAM,EAAE,MAAM,GAAG,QAAQ,EACzB,kBAAkB,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GACvE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzB;;;;OAIG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;;;OAIG;IACG,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAIpC;;;;OAIG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;IACG,mBAAmB,IAAI,OAAO,CAAC,IAAI,CAAC;IAI1C;;;;OAIG;IACG,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;IAIlC;;;;;;OAMG;WACU,SAAS,CACpB,MAAM,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,EACrC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,QAAQ,CAAC;IAKpB,MAAM;CA6CP"}

package/build/Image.types.d.ts

@@ -140,7 +140,7 @@ export interface ImageProps extends Omit<ViewProps, 'style' | 'children'> {
     blurRadius?: number;
     /**
      * A color used to tint template images (a bitmap image where only the opacity matters).
-     * The color is applied to every non-transparent pixel, causing the image’s shape to adopt that color.
+     * The color is applied to every non-transparent pixel, causing the image's shape to adopt that color.
      * This effect is not applied to placeholders.
      * @default null
      */
@@ -264,12 +264,12 @@ export interface ImageProps extends Omit<ViewProps, 'style' | 'children'> {
      */
     accessible?: boolean;
     /**
-     * The text that's read by the screen reader when the user interacts with the image. Sets the the `alt` tag on web which is used for web crawlers and link traversal.
+     * The text that's read by the screen reader when the user interacts with the image. Sets the `alt` tag on web which is used for web crawlers and link traversal.
      * @default undefined
      */
     accessibilityLabel?: string;
     /**
-     * The text that's read by the screen reader when the user interacts with the image. Sets the the `alt` tag on web which is used for web crawlers and link traversal. Is an alias for `accessibilityLabel`.
+     * The text that's read by the screen reader when the user interacts with the image. Sets the `alt` tag on web which is used for web crawlers and link traversal. Is an alias for `accessibilityLabel`.
      *
      * @alias accessibilityLabel
      * @default undefined
@@ -313,6 +313,15 @@ export interface ImageProps extends Omit<ViewProps, 'style' | 'children'> {
      * @platform ios
      */
     useAppleWebpCodec?: boolean;
+    /**
+     * Force early resizing of the image to match the container size.
+     * This option helps to reduce the memory usage of the image view, especially when the image is larger than the container.
+     * It may affect the `resizeType` and `contentPosition` properties when the image view is resized dynamically.
+     *
+     * @default false
+     * @platform ios
+     */
+    enforceEarlyResizing?: boolean;
 }
 /**
  * It narrows down some props to types expected by the native/web side.
@@ -375,10 +384,14 @@ export type ImageContentPosition =
     bottom?: ImageContentPositionValue;
     left?: ImageContentPositionValue;
 } | ImageContentPositionString;
+/**
+ * It allows you to use an image as a background while rendering other content on top of it.
+ * It extends all `Image` props but provides separate styling controls for the container and the background image itself.
+ */
 export interface ImageBackgroundProps extends Omit<ImageProps, 'style'> {
-    /** The style of the image container */
+    /** The style of the image container. */
     style?: StyleProp<ViewStyle> | undefined;
-    /** Style object for the image */
+    /** Style object for the image. */
     imageStyle?: StyleProp<RNImageStyle> | undefined;
     /** @hidden */
     children?: React.ReactNode | undefined;

package/build/Image.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Image.types.d.ts","sourceRoot":"","sources":["../src/Image.types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Image.types.d.ts","sourceRoot":"","sources":["../src/Image.types.ts"],"names":[],"mappings":"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"}

package/build/web/ImageWrapper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ImageWrapper.d.ts","sourceRoot":"","sources":["../../src/web/ImageWrapper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAqBzD,QAAA,MAAM,YAAY,4FA4DjB,CAAC;AAEF,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ImageWrapper.d.ts","sourceRoot":"","sources":["../../src/web/ImageWrapper.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAgC,MAAM,OAAO,CAAC;AAGrD,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAqBzD,QAAA,MAAM,YAAY,4FAmEjB,CAAC;AAEF,eAAe,YAAY,CAAC"}

package/expo-module.config.json

@@ -8,7 +8,7 @@
     "publication": {
       "groupId": "BareExpo",
       "artifactId": "expo.modules.image",
-      "version": "2.3.2",
+      "version": "2.4.0-canary-20250709-136b77f",
       "repository": "local-maven-repo"
     }
   }

package/ios/ExpoImage.podspec

@@ -14,7 +14,7 @@ Pod::Spec.new do |s|
     :ios => '15.1',
     :tvos => '15.1'
   }
-  s.swift_version  = '5.4'
+  s.swift_version  = '5.9'
   s.source         = { git: 'https://github.com/expo/expo.git' }
   s.static_framework = true
 

package/ios/ImageModule.swift

@@ -111,6 +111,10 @@ public final class ImageModule: Module {
         view.useAppleWebpCodec = useAppleWebpCodec
       }
 
+      Prop("enforceEarlyResizing", false) { (view, enforceEarlyResizing: Bool) in
+        view.enforceEarlyResizing = enforceEarlyResizing
+      }
+
       AsyncFunction("startAnimating") { (view: ImageView) in
         view.sdImageView.startAnimating()
       }
@@ -166,19 +170,28 @@ public final class ImageModule: Module {
       }
     }
 
-    AsyncFunction("generateBlurhashAsync") { (url: URL, numberOfComponents: CGSize, promise: Promise) in
+    AsyncFunction("generateBlurhashAsync") { (source: Either<Image, URL>, numberOfComponents: CGSize, promise: Promise) in
       let downloader = SDWebImageDownloader()
-      let parsedNumberOfComponents = (Int(numberOfComponents.width), Int(numberOfComponents.height))
-      downloader.downloadImage(with: url, progress: nil, completed: { image, _, _, _ in
-        DispatchQueue.global().async {
-          if let downloadedImage = image {
-            let blurhashString = blurhash(fromImage: downloadedImage, numberOfComponents: parsedNumberOfComponents)
-            promise.resolve(blurhashString)
-          } else {
-            promise.reject(BlurhashGenerationException())
-          }
+      let parsedNumberOfComponents = (width: Int(numberOfComponents.width), height: Int(numberOfComponents.height))
+
+      if let image: Image = source.get() {
+        if let blurhashString = blurhash(fromImage: image.ref, numberOfComponents: parsedNumberOfComponents) {
+          promise.resolve(blurhashString)
+        } else {
+          promise.reject(BlurhashGenerationException())
         }
-      })
+      } else if let url: URL = source.get() {
+        downloader.downloadImage(with: url, progress: nil, completed: { image, _, _, _ in
+          DispatchQueue.global().async {
+            if let downloadedImage = image {
+              let blurhashString = blurhash(fromImage: downloadedImage, numberOfComponents: parsedNumberOfComponents)
+              promise.resolve(blurhashString)
+            } else {
+              promise.reject(BlurhashGenerationException())
+            }
+          }
+        })
+      }
     }
 
     AsyncFunction("clearMemoryCache") { () -> Bool in

package/ios/ImageView.swift

@@ -12,6 +12,8 @@ typealias SDWebImageContext = [SDWebImageContextOption: Any]
 public final class ImageView: ExpoView {
   static let contextSourceKey = SDWebImageContextOption(rawValue: "source")
   static let screenScaleKey = SDWebImageContextOption(rawValue: "screenScale")
+  static let contentFitKey = SDWebImageContextOption(rawValue: "contentFit")
+  static let frameSizeKey = SDWebImageContextOption(rawValue: "frameSize")
 
   let sdImageView = SDAnimatedImageView(frame: .zero)
 
@@ -58,6 +60,8 @@ public final class ImageView: ExpoView {
 
   var lockResource: Bool = false
 
+  var enforceEarlyResizing: Bool = false
+
   var recyclingKey: String? {
     didSet {
       if oldValue != nil && recyclingKey != oldValue {
@@ -161,7 +165,8 @@ public final class ImageView: ExpoView {
 
     // It seems that `UIImageView` can't tint some vector graphics. If the `tintColor` prop is specified,
     // we tell the SVG coder to decode to a bitmap instead. This will become useless when we switch to SVGNative coder.
-    if imageTintColor != nil {
+    let shouldEarlyResize = imageTintColor != nil || enforceEarlyResizing
+    if shouldEarlyResize {
       context[.imagePreserveAspectRatio] = true
       context[.imageThumbnailPixelSize] = CGSize(
         width: sdImageView.bounds.size.width * screenScale,
@@ -171,6 +176,8 @@ public final class ImageView: ExpoView {
 
     // Some loaders (e.g. PhotoLibraryAssetLoader) may need to know the screen scale.
     context[ImageView.screenScaleKey] = screenScale
+    context[ImageView.frameSizeKey] = frame.size
+    context[ImageView.contentFitKey] = contentFit
 
     // Do it here so we don't waste resources trying to fetch from a remote URL
     if maybeRenderLocalAsset(from: source) {

package/ios/Loaders/PhotoLibraryAssetLoader.swift

@@ -107,9 +107,23 @@ private func requestAsset(
     }
   }
 
+  var targetSize = PHImageManagerMaximumSize
+
+  // We compute the minimal size required to display the image to avoid having to downsample it later
+  if let scale = context?[ImageView.screenScaleKey] as? Double,
+    let containerSize = context?[ImageView.frameSizeKey] as? CGSize,
+    let contentFit = context?[ImageView.contentFitKey] as? ContentFit {
+    let targetSize = idealSize(
+      contentPixelSize: CGSize(width: asset.pixelWidth, height: asset.pixelHeight),
+      containerSize: containerSize,
+      scale: scale,
+      contentFit: contentFit
+    ).rounded(.up) * scale
+  }
+
   return PHImageManager.default().requestImage(
     for: asset,
-    targetSize: PHImageManagerMaximumSize,
+    targetSize: targetSize,
     contentMode: .aspectFit,
     options: options,
     resultHandler: { image, info in

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f-sources.jar.md5

@@ -0,0 +1 @@
+3a0b848e71aa5eaefb084675eb50c305

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f-sources.jar.sha1

@@ -0,0 +1 @@
+352aa667f536a581a22180f9d12871019d065320

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f-sources.jar.sha256

@@ -0,0 +1 @@
+577257f4b8cf651fe9ed849c1250f9f09e6c1854e1f7bb64b629b4b4216c77ee

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f-sources.jar.sha512

@@ -0,0 +1 @@
+05a1cead66b82e284630207150f467c7ee6d64a9ca2de41f577d350148fa8fe60fbcec54bda5ebc8919abccefa4a55d58870ee4ccfe6961fd606ace3c1c707c6

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.aar.md5

@@ -0,0 +1 @@
+ede5ceb6ae9d04e443d6ada39204ea46

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.aar.sha1

@@ -0,0 +1 @@
+034f22c314e21aff779c27d6b3318375e53f75fd

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.aar.sha256

@@ -0,0 +1 @@
+d37a5801d9bc31976bc07304261903d2f384c37c7ac4d44f87bc761d0c8aa6eb

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.aar.sha512

@@ -0,0 +1 @@
+13b6a7e526fc661313b603d3032aa875fecaadf27dc0a763d817e899e30be579a9ba7549a57589e9b3bca7ff3ea36aab4f55bd1790cb0ab3c5a65fcca1a23a8a

package/local-maven-repo/BareExpo/expo.modules.image/{2.3.2/expo.modules.image-2.3.2.module → 2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.module}

@@ -3,14 +3,14 @@
   "component": {
     "group": "BareExpo",
     "module": "expo.modules.image",
-    "version": "2.3.2",
+    "version": "2.4.0-canary-20250709-136b77f",
     "attributes": {
       "org.gradle.status": "release"
     }
   },
   "createdBy": {
     "gradle": {
-      "version": "8.13"
+      "version": "8.14"
     }
   },
   "variants": [
@@ -54,13 +54,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.image-2.3.2.aar",
-          "url": "expo.modules.image-2.3.2.aar",
-          "size": 279544,
-          "sha512": "47c107c9a1134bb50953e5cf037cdc5aef8088d6c1bce906d268f2cf2c6b1a2692dbbd4cf686922d9eded7a78e275fea8038b91267fffd31957fa68b297bdae8",
-          "sha256": "5d682f47a7031c3d5403faf294bb898f52299dcc73903682475cc310c39e70ac",
-          "sha1": "af130ea05cd1ce374351bdb409b187b699baeef7",
-          "md5": "5c50faf7e63489ecc2e5d3ab07a2f707"
+          "name": "expo.modules.image-2.4.0-canary-20250709-136b77f.aar",
+          "url": "expo.modules.image-2.4.0-canary-20250709-136b77f.aar",
+          "size": 293614,
+          "sha512": "13b6a7e526fc661313b603d3032aa875fecaadf27dc0a763d817e899e30be579a9ba7549a57589e9b3bca7ff3ea36aab4f55bd1790cb0ab3c5a65fcca1a23a8a",
+          "sha256": "d37a5801d9bc31976bc07304261903d2f384c37c7ac4d44f87bc761d0c8aa6eb",
+          "sha1": "034f22c314e21aff779c27d6b3318375e53f75fd",
+          "md5": "ede5ceb6ae9d04e443d6ada39204ea46"
         }
       ]
     },
@@ -77,7 +77,7 @@
           "group": "org.jetbrains.kotlin",
           "module": "kotlin-stdlib-jdk7",
           "version": {
-            "requires": "2.0.21"
+            "requires": "2.1.20"
           }
         },
         {
@@ -143,13 +143,13 @@
       ],
       "files": [
         {
-          "name": "expo.modules.image-2.3.2.aar",
-          "url": "expo.modules.image-2.3.2.aar",
-          "size": 279544,
-          "sha512": "47c107c9a1134bb50953e5cf037cdc5aef8088d6c1bce906d268f2cf2c6b1a2692dbbd4cf686922d9eded7a78e275fea8038b91267fffd31957fa68b297bdae8",
-          "sha256": "5d682f47a7031c3d5403faf294bb898f52299dcc73903682475cc310c39e70ac",
-          "sha1": "af130ea05cd1ce374351bdb409b187b699baeef7",
-          "md5": "5c50faf7e63489ecc2e5d3ab07a2f707"
+          "name": "expo.modules.image-2.4.0-canary-20250709-136b77f.aar",
+          "url": "expo.modules.image-2.4.0-canary-20250709-136b77f.aar",
+          "size": 293614,
+          "sha512": "13b6a7e526fc661313b603d3032aa875fecaadf27dc0a763d817e899e30be579a9ba7549a57589e9b3bca7ff3ea36aab4f55bd1790cb0ab3c5a65fcca1a23a8a",
+          "sha256": "d37a5801d9bc31976bc07304261903d2f384c37c7ac4d44f87bc761d0c8aa6eb",
+          "sha1": "034f22c314e21aff779c27d6b3318375e53f75fd",
+          "md5": "ede5ceb6ae9d04e443d6ada39204ea46"
         }
       ]
     },
@@ -163,13 +163,13 @@
       },
       "files": [
         {
-          "name": "expo.modules.image-2.3.2-sources.jar",
-          "url": "expo.modules.image-2.3.2-sources.jar",
-          "size": 64200,
-          "sha512": "4fd35480bc1edafe3727afbfb6b1d9cf69643f30523402e7512a8b2944d17915150373225d5aed1c344b80ad9c9b3fe1ff1050b2c83a13c8faa34956ddef588e",
-          "sha256": "d91f60ce8ec04a24413f687b5596f0165504d5b55d05c380daea5b155e537100",
-          "sha1": "9d61b3b9a11effe5d06c77755eaa06d86da5d422",
-          "md5": "754e5c8b8c3d801d36965a6cf0ec673a"
+          "name": "expo.modules.image-2.4.0-canary-20250709-136b77f-sources.jar",
+          "url": "expo.modules.image-2.4.0-canary-20250709-136b77f-sources.jar",
+          "size": 66715,
+          "sha512": "05a1cead66b82e284630207150f467c7ee6d64a9ca2de41f577d350148fa8fe60fbcec54bda5ebc8919abccefa4a55d58870ee4ccfe6961fd606ace3c1c707c6",
+          "sha256": "577257f4b8cf651fe9ed849c1250f9f09e6c1854e1f7bb64b629b4b4216c77ee",
+          "sha1": "352aa667f536a581a22180f9d12871019d065320",
+          "md5": "3a0b848e71aa5eaefb084675eb50c305"
         }
       ]
     }

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.module.md5

@@ -0,0 +1 @@
+053aece4301f9dc4bf55e98baf457e86

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.module.sha1

@@ -0,0 +1 @@
+a2ec808d3c72fe5b07ef8b9478f7b34fcafde103

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.module.sha256

@@ -0,0 +1 @@
+09a54a93f355d235bfe17c5114155305ee1eaf0d8d42384fa68cba1da36964bf

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.module.sha512

@@ -0,0 +1 @@
+01a52b8c9a218146e47fafecd23748e28bf183f13fb2a61cb23b0dd363729c227a1520cc2ba5e3bf8923c1d316e05478d0b08d42819ba04b6085c1309d3ccbb5

package/local-maven-repo/BareExpo/expo.modules.image/{2.3.2/expo.modules.image-2.3.2.pom → 2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.pom}

@@ -9,7 +9,7 @@
   <modelVersion>4.0.0</modelVersion>
   <groupId>BareExpo</groupId>
   <artifactId>expo.modules.image</artifactId>
-  <version>2.3.2</version>
+  <version>2.4.0-canary-20250709-136b77f</version>
   <packaging>aar</packaging>
   <name>expo.modules.image</name>
   <url>https://github.com/expo/expo</url>
@@ -52,7 +52,7 @@
     <dependency>
       <groupId>org.jetbrains.kotlin</groupId>
       <artifactId>kotlin-stdlib-jdk7</artifactId>
-      <version>2.0.21</version>
+      <version>2.1.20</version>
       <scope>runtime</scope>
     </dependency>
     <dependency>

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.pom.md5

@@ -0,0 +1 @@
+4de80a245e8161528cca7c8c74925c4b

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.pom.sha1

@@ -0,0 +1 @@
+d55ac1a2b59ccf28bf6dcfc204f3468733d62a1a

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.pom.sha256

@@ -0,0 +1 @@
+93724cb41ba9ea118a1ac9b7a2fba5ca4bd244a694b208d9f36b767a2799a954

package/local-maven-repo/BareExpo/expo.modules.image/2.4.0-canary-20250709-136b77f/expo.modules.image-2.4.0-canary-20250709-136b77f.pom.sha512

@@ -0,0 +1 @@
+feae52ca8fb6026beeef51acc6b8f4889f9994c94f891343e0733a4415a0b50db2d7cd80bd019dea54fb287f9104ae1873d2a0e65dab3acf49a968cb84375051

package/local-maven-repo/BareExpo/expo.modules.image/maven-metadata.xml

@@ -3,11 +3,11 @@
   <groupId>BareExpo</groupId>
   <artifactId>expo.modules.image</artifactId>
   <versioning>
-    <latest>2.3.2</latest>
-    <release>2.3.2</release>
+    <latest>2.4.0-canary-20250709-136b77f</latest>
+    <release>2.4.0-canary-20250709-136b77f</release>
     <versions>
-      <version>2.3.2</version>
+      <version>2.4.0-canary-20250709-136b77f</version>
     </versions>
-    <lastUpdated>20250701155759</lastUpdated>
+    <lastUpdated>20250709123311</lastUpdated>
   </versioning>
 </metadata>

package/local-maven-repo/BareExpo/expo.modules.image/maven-metadata.xml.md5

@@ -1 +1 @@
-4ad31226fb6dfe828d50ead85bca40b4
+79100949da845df78c586112149ce73f

package/local-maven-repo/BareExpo/expo.modules.image/maven-metadata.xml.sha1

@@ -1 +1 @@
-e8165ce2412191e00e0188eb7e066c9e2454a7f8
+f3a681b2debb9340295ebefc8c191c4f801f6d83

package/local-maven-repo/BareExpo/expo.modules.image/maven-metadata.xml.sha256

@@ -1 +1 @@
-024e30b789f8aec85dd5e0fb878211d0f3a991ba08f925f639024edb51317e4f
+86954d43778efdf5a57e9d3cb1ef077bfc4d0241480420ab1dcc699f80d70f32

package/local-maven-repo/BareExpo/expo.modules.image/maven-metadata.xml.sha512

@@ -1 +1 @@
-09ad0049527394985a358ee97cabaa55f7a0fcdacc994d0347a3c38c829136fb816932373c718d0fca25951c5676facd59980da58e36e61daa5e08585bdd8532
+a69168ee5e6f21ac5b064b227c32d148e1fb8082158c4a93880a222452291d6a895673f4f525478b956a7c59b3d3fca18453ce6ef4ff73dd2dd5ec1820c45f94

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "expo-image",
   "title": "Expo Image",
-  "version": "2.3.2",
+  "version": "2.4.0-canary-20250709-136b77f",
   "description": "A cross-platform, performant image component for React Native and Expo with Web support",
   "main": "src/index.ts",
   "types": "build/index.d.ts",
@@ -29,10 +29,10 @@
   "license": "MIT",
   "dependencies": {},
   "devDependencies": {
-    "expo-module-scripts": "^4.1.8"
+    "expo-module-scripts": "4.1.10-canary-20250709-136b77f"
   },
   "peerDependencies": {
-    "expo": "*",
+    "expo": "54.0.0-canary-20250709-136b77f",
     "react": "*",
     "react-native": "*",
     "react-native-web": "*"
@@ -44,6 +44,5 @@
   },
   "jest": {
     "preset": "expo-module-scripts"
-  },
-  "gitHead": "34824ca1e6fb52d70d5488d32fe790234f3c3100"
+  }
 }

package/src/ExpoImage.web.tsx

@@ -75,6 +75,7 @@ export default function ExpoImage({
   style,
   nativeViewRef,
   accessibilityLabel,
+  alt,
   tintColor,
   containerViewRef,
   ...props
@@ -114,7 +115,7 @@ export default function ExpoImage({
               contentPosition={{ left: '50%', top: '50%' }}
               hashPlaceholderContentPosition={contentPosition}
               hashPlaceholderStyle={imageHashStyle}
-              accessibilityLabel={accessibilityLabel}
+              accessibilityLabel={accessibilityLabel ?? alt}
               cachePolicy={cachePolicy}
               priority={priority}
               tintColor={tintColor}

package/src/Image.tsx

@@ -129,17 +129,18 @@ export class Image extends React.PureComponent<ImageProps> {
 
   /**
    * Asynchronously generates a [Blurhash](https://blurha.sh) from an image.
-   * @param url - The URL of the image to generate a blurhash from.
+   * @param source - The image source, either a URL (string) or an ImageRef
    * @param numberOfComponents - The number of components to encode the blurhash with.
    * Must be between 1 and 9. Defaults to `[4, 3]`.
+   * @platform android
    * @platform ios
    * @return A promise resolving to the blurhash string.
    */
   static async generateBlurhashAsync(
-    url: string,
+    source: string | ImageRef,
     numberOfComponents: [number, number] | { width: number; height: number }
   ): Promise<string | null> {
-    return await ImageModule.generateBlurhashAsync(url, numberOfComponents);
+    return ImageModule.generateBlurhashAsync(source, numberOfComponents);
   }
 
   /**

package/src/Image.types.ts

@@ -164,7 +164,7 @@ export interface ImageProps extends Omit<ViewProps, 'style' | 'children'> {
 
   /**
    * A color used to tint template images (a bitmap image where only the opacity matters).
-   * The color is applied to every non-transparent pixel, causing the image’s shape to adopt that color.
+   * The color is applied to every non-transparent pixel, causing the image's shape to adopt that color.
    * This effect is not applied to placeholders.
    * @default null
    */
@@ -308,13 +308,13 @@ export interface ImageProps extends Omit<ViewProps, 'style' | 'children'> {
   accessible?: boolean;
 
   /**
-   * The text that's read by the screen reader when the user interacts with the image. Sets the the `alt` tag on web which is used for web crawlers and link traversal.
+   * The text that's read by the screen reader when the user interacts with the image. Sets the `alt` tag on web which is used for web crawlers and link traversal.
    * @default undefined
    */
   accessibilityLabel?: string;
 
   /**
-   * The text that's read by the screen reader when the user interacts with the image. Sets the the `alt` tag on web which is used for web crawlers and link traversal. Is an alias for `accessibilityLabel`.
+   * The text that's read by the screen reader when the user interacts with the image. Sets the `alt` tag on web which is used for web crawlers and link traversal. Is an alias for `accessibilityLabel`.
    *
    * @alias accessibilityLabel
    * @default undefined
@@ -362,6 +362,16 @@ export interface ImageProps extends Omit<ViewProps, 'style' | 'children'> {
    * @platform ios
    */
   useAppleWebpCodec?: boolean;
+
+  /**
+   * Force early resizing of the image to match the container size.
+   * This option helps to reduce the memory usage of the image view, especially when the image is larger than the container.
+   * It may affect the `resizeType` and `contentPosition` properties when the image view is resized dynamically.
+   *
+   * @default false
+   * @platform ios
+   */
+  enforceEarlyResizing?: boolean;
 }
 
 /**
@@ -429,10 +439,14 @@ export type ImageContentPosition =
     }
   | ImageContentPositionString;
 
+/**
+ * It allows you to use an image as a background while rendering other content on top of it.
+ * It extends all `Image` props but provides separate styling controls for the container and the background image itself.
+ */
 export interface ImageBackgroundProps extends Omit<ImageProps, 'style'> {
-  /** The style of the image container */
+  /** The style of the image container. */
   style?: StyleProp<ViewStyle> | undefined;
-  /** Style object for the image */
+  /** Style object for the image. */
   imageStyle?: StyleProp<RNImageStyle> | undefined;
   /** @hidden */
   children?: React.ReactNode | undefined;

package/src/web/ImageWrapper.tsx

@@ -44,7 +44,14 @@ const ImageWrapper = React.forwardRef(
       events?.onMount?.forEach((e) => e?.());
     }, []);
 
-    const tintId = useId();
+    // Use a unique ID for the SVG filter so that multiple <Image> can be used
+    // on the same page with different tint colors without conflicts.
+    const tintId = useId()
+      // Make it safe for use as an SVG ID. SVG IDs are most strict than HTML
+      // IDs. They must be compliant with https://www.w3.org/TR/xml/#NT-Name.
+      // React 19 changed useId() to include « and ». These must be removed or
+      // the SVG filter will not work (e.g. in Safari which enforces the spec).
+      .replace(/[«»]/g, '_');
 
     // Thumbhash uri always has to start with 'thumbhash:/'
     const { resolvedSource, isImageHash } = useImageHashes(source);

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2-sources.jar.md5

@@ -1 +0,0 @@
-754e5c8b8c3d801d36965a6cf0ec673a

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2-sources.jar.sha1

@@ -1 +0,0 @@
-9d61b3b9a11effe5d06c77755eaa06d86da5d422

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2-sources.jar.sha256

@@ -1 +0,0 @@
-d91f60ce8ec04a24413f687b5596f0165504d5b55d05c380daea5b155e537100

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2-sources.jar.sha512

@@ -1 +0,0 @@
-4fd35480bc1edafe3727afbfb6b1d9cf69643f30523402e7512a8b2944d17915150373225d5aed1c344b80ad9c9b3fe1ff1050b2c83a13c8faa34956ddef588e

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.aar.md5

@@ -1 +0,0 @@
-5c50faf7e63489ecc2e5d3ab07a2f707

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.aar.sha1

@@ -1 +0,0 @@
-af130ea05cd1ce374351bdb409b187b699baeef7

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.aar.sha256

@@ -1 +0,0 @@
-5d682f47a7031c3d5403faf294bb898f52299dcc73903682475cc310c39e70ac

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.aar.sha512

@@ -1 +0,0 @@
-47c107c9a1134bb50953e5cf037cdc5aef8088d6c1bce906d268f2cf2c6b1a2692dbbd4cf686922d9eded7a78e275fea8038b91267fffd31957fa68b297bdae8

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.module.md5

@@ -1 +0,0 @@
-7af4ff2f7c924b72b5d247d1a8e4b595

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.module.sha1

@@ -1 +0,0 @@
-ec838d463d942c5f4c7292383a925a84e0aee64a

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.module.sha256

@@ -1 +0,0 @@
-4df5ed4d362d6629d7e0f6b8be64e8ba5c7131233e831b6b261da9f7f1e8066c

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.module.sha512

@@ -1 +0,0 @@
-2df4c319bd63061776f34544f30d204adfb64ffb604a6179cbcf49f63a7194bfa07bf0cd491c40c03111fe2ce6fb9ec46ff321504ee63819681e23773d82f99b

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.pom.md5

@@ -1 +0,0 @@
-63cf17cf173c4f6130d40f99214aa25c

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.pom.sha1

@@ -1 +0,0 @@
-52de8ca8a076d145cff287efb578b39c10112171

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.pom.sha256

@@ -1 +0,0 @@
-13c3f88c0dff66426230901a9cb1a7cc1c4f1452e6e15e4108062d3a02009c8a

package/local-maven-repo/BareExpo/expo.modules.image/2.3.2/expo.modules.image-2.3.2.pom.sha512

@@ -1 +0,0 @@
-2280a33df6c419059d21badc5bebb4c3fba42d30b50bbca5bddd80cd1895ae12baae65da7cd5d411cd37e1a9db21fd84f61cd6c15b480e5d8421f90b24d06719