react-native-nitro-image-pipeline 1.1.0 → 1.2.0

package/README.md

@@ -10,7 +10,7 @@ A high-performance image loading, caching, and processing library for React Nati
 
 - Load remote images with built-in memory and disk caching
 - Prefetch single or multiple images in the background
-- Apply Gaussian blur and rounded corners (uniform or per-corner) at load time
+- Resize (aspect-fill, center-crop) and apply Gaussian blur and rounded corners (uniform or per-corner) at load time
 - Apply Gaussian blur to already-loaded images
 - Clear the image cache on demand
 - `useImage` hook for declarative image loading in components
@@ -46,10 +46,14 @@ The simplest way to load an image in a component:
 import { useImage } from 'react-native-nitro-image-pipeline';
 
 function MyComponent() {
+  const px = PixelRatio.get();
   const { image, error } = useImage({
     url: 'https://example.com/photo.jpg',
-    blur: 4, // Gaussian sigma in source pixels — same result on iOS and Android
-    cornerRadius: 12,
+    blur: 4, // Gaussian sigma in bitmap pixels — same result on iOS and Android
+    // Resize to the size you display (points × screen scale) so the corner
+    // radii apply 1:1 to what you see instead of the full-resolution source.
+    resize: { width: 300 * px, height: 200 * px },
+    cornerRadius: 12 * px,
   });
 
   if (error) return <Text>Failed to load image</Text>;
@@ -65,9 +69,12 @@ function MyComponent() {
 ```ts
 import { NitroImagePipeline } from 'react-native-nitro-image-pipeline';
 
-// Load an image with options
+// Load an image with options. resize and cornerRadius are in pixels of the
+// produced bitmap: without resize, the radius applies to the full-resolution
+// source and shrinks along with it when displayed small.
 const image = await NitroImagePipeline.loadImage('https://example.com/photo.jpg', {
-  blur: 4, // Gaussian sigma in source pixels — see "Blur units"
+  blur: 4, // Gaussian sigma in bitmap pixels — see "Blur units"
+  resize: { width: 600, height: 400 }, // aspect-fill + center-crop, exact output size
   cornerRadius: 12,
   cache: 'disk',
 });
@@ -75,6 +82,7 @@ const image = await NitroImagePipeline.loadImage('https://example.com/photo.jpg'
 // Per-corner radii — e.g. a "ticket" shape with larger bottom corners.
 // The rounding is baked into the bitmap, so no view-layer masking is needed.
 const ticket = await NitroImagePipeline.loadImage('https://example.com/photo.jpg', {
+  resize: { width: 600, height: 400 },
   cornerRadius: { topLeft: 24, topRight: 24, bottomLeft: 48, bottomRight: 48 },
 });
 
@@ -103,7 +111,8 @@ Loads an image from a URL and returns a `Promise<Image>`.
 | Option | Type | Default | Description |
 |---|---|---|---|
 | `blur` | `number` | `0` | Gaussian blur strength applied at load time — see [Blur units](#blur-units) |
-| `cornerRadius` | `number \| CornerRadii` | `0` | Corner radius in points — a single number for all four corners, or `{ topLeft?, topRight?, bottomLeft?, bottomRight? }` for independent per-corner radii (omitted corners stay square) |
+| `resize` | `{ width, height }` | source size | Target bitmap size in pixels. Scales to fill and center-crops (CSS `object-fit: cover`, upscaling if needed) before `blur`/`cornerRadius` run, so their pixel units refer to this final size. Typically your display size in points × `PixelRatio.get()` |
+| `cornerRadius` | `number \| CornerRadii` | `0` | Corner radius in pixels of the produced bitmap — a single number for all four corners, or `{ topLeft?, topRight?, bottomLeft?, bottomRight? }` for independent per-corner radii (omitted corners stay square). Pair with `resize` for radii that match your layout |
 | `cache` | `'memory' \| 'disk' \| 'none'` | platform default | Caching strategy |
 
 ### `preLoadImage(url)`

package/android/src/main/java/com/margelo/nitro/nitroimagepipeline/HybridNitroImagePipeline.kt

@@ -14,6 +14,7 @@ import coil3.request.ImageRequest
 import coil3.request.SuccessResult
 import coil3.request.allowHardware
 import coil3.request.transformations
+import coil3.size.Scale
 import coil3.size.Size
 import coil3.transform.RoundedCornersTransformation
 import com.google.net.cronet.okhttptransport.CronetInterceptor
@@ -22,6 +23,8 @@ import com.margelo.nitro.core.Promise
 import com.margelo.nitro.image.HybridImage
 import com.margelo.nitro.image.HybridImageSpec
 import com.margelo.nitro.nitroimagepipeline.transform.BlurTransformation
+import com.margelo.nitro.nitroimagepipeline.transform.ResizeTransformation
+import kotlin.math.roundToInt
 import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.async
 import kotlinx.coroutines.awaitAll
@@ -40,7 +43,16 @@ class HybridNitroImagePipeline : HybridNitroImagePipelineSpec() {
 
   override fun loadImage(url: String, options: Options?): Promise<HybridImageSpec> = Promise.async {
     val blur = options?.blur?.toFloat() ?: 0f
+    val resize =
+        options?.resize?.let { r ->
+          val width = r.width.roundToInt()
+          val height = r.height.roundToInt()
+          if (width > 0 && height > 0) width to height else null
+        }
     val transformations = buildList {
+      // Resize first: blur sigma and corner radii are in pixels of the bitmap
+      // they run on, so they must see the final size.
+      resize?.let { (width, height) -> add(ResizeTransformation(width, height)) }
       if (blur > 0f) add(BlurTransformation(context, blur))
       options?.cornerRadius?.match(
           first = { radius ->
@@ -77,6 +89,13 @@ class HybridNitroImagePipeline : HybridNitroImagePipelineSpec() {
                 }
                 null -> Unit // Coil defaults: both enabled
               }
+              // Ask the decoder for the target size so a large source is
+              // subsampled near it instead of decoded at full resolution;
+              // ResizeTransformation then makes the size exact.
+              resize?.let { (width, height) ->
+                size(width, height)
+                scale(Scale.FILL)
+              }
             }
             .allowHardware(true)
             .transformations(transformations)

package/android/src/main/java/com/margelo/nitro/nitroimagepipeline/transform/ResizeTransformation.kt

@@ -0,0 +1,59 @@
+package com.margelo.nitro.nitroimagepipeline.transform
+
+import android.graphics.Bitmap
+import android.graphics.Canvas
+import android.graphics.Matrix
+import android.graphics.Paint
+import coil3.size.Size
+import coil3.transform.Transformation
+import kotlin.math.max
+
+/**
+ * Scales the input to fill exactly [width] × [height] pixels and center-crops the overflow (CSS
+ * `object-fit: cover`), upscaling smaller sources. It runs before [BlurTransformation] and rounded
+ * corners so their pixel units refer to the final bitmap — matching Nuke's
+ * `ImageProcessors.Resize(contentMode: .aspectFill, crop: true)` on iOS.
+ */
+class ResizeTransformation(
+    private val width: Int,
+    private val height: Int,
+) : Transformation() {
+
+  init {
+    require(width > 0 && height > 0) { "width and height must be > 0." }
+  }
+
+  override val cacheKey = "${ResizeTransformation::class.java.name}-$width-$height"
+
+  override suspend fun transform(input: Bitmap, size: Size): Bitmap {
+    val softwareInput =
+        if (input.config == Bitmap.Config.HARDWARE) input.copy(Bitmap.Config.ARGB_8888, false)
+        else input
+    if (softwareInput.width == width && softwareInput.height == height) return softwareInput
+
+    val scale =
+        max(width.toFloat() / softwareInput.width, height.toFloat() / softwareInput.height)
+    val matrix =
+        Matrix().apply {
+          setScale(scale, scale)
+          postTranslate(
+              (width - softwareInput.width * scale) / 2f,
+              (height - softwareInput.height * scale) / 2f,
+          )
+        }
+    val config = softwareInput.config ?: Bitmap.Config.ARGB_8888
+    val output = Bitmap.createBitmap(width, height, config)
+    Canvas(output)
+        .drawBitmap(softwareInput, matrix, Paint(Paint.ANTI_ALIAS_FLAG or Paint.FILTER_BITMAP_FLAG))
+    return output
+  }
+
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    return other is ResizeTransformation && width == other.width && height == other.height
+  }
+
+  override fun hashCode(): Int = 31 * width + height
+
+  override fun toString() = "ResizeTransformation(width=$width, height=$height)"
+}

package/ios/HybridNitroImagePipeline.swift

@@ -117,6 +117,17 @@ class HybridNitroImagePipeline: HybridNitroImagePipelineSpec {
             }
 
             var processors: [any ImageProcessing] = []
+            // Resize first: blur sigma and corner radii are defined in pixels
+            // of the bitmap they run on, so they must see the final size.
+            if let resize = options?.resize, resize.width > 0, resize.height > 0 {
+                processors.append(ImageProcessors.Resize(
+                    size: CGSize(width: resize.width, height: resize.height),
+                    unit: .pixels,
+                    contentMode: .aspectFill,
+                    crop: true,
+                    upscale: true
+                ))
+            }
             if let blur = options?.blur, blur > 0 {
                 processors.append(GaussianBlurProcessor(sigma: blur))
             }

package/ios/RoundedCornersProcessor.swift

@@ -12,8 +12,11 @@ import Foundation
 import Nuke
 import UIKit
 
-/// Nuke processor that rounds each corner with its own radius (in points,
-/// like `ImageProcessors.RoundedCorners` with `unit: .points`).
+/// Nuke processor that rounds each corner with its own radius, measured in
+/// pixels of the bitmap it receives (like `ImageProcessors.RoundedCorners`
+/// with `unit: .points` on the scale-1 images the pipeline decodes). Runs
+/// after `ImageProcessors.Resize` when `Options.resize` is set, so the radii
+/// refer to the final output size.
 struct RoundedCornersProcessor: ImageProcessing {
     let topLeft: CGFloat
     let topRight: CGFloat

package/lib/commonjs/index.js

@@ -20,6 +20,7 @@ function useImage({
   url,
   blur = 0,
   cornerRadius = 0,
+  resize,
   cache
 }) {
   const [image, setImage] = (0, _react.useState)({
@@ -38,6 +39,8 @@ function useImage({
     bottomLeft = 0,
     bottomRight = 0
   } = isUniformRadius ? {} : cornerRadius;
+  const resizeWidth = resize?.width ?? 0;
+  const resizeHeight = resize?.height ?? 0;
   (0, _react.useEffect)(() => {
     let cancelled = false;
     // Only reset to the loading state when the URL changes; for same-URL
@@ -60,6 +63,10 @@ function useImage({
             bottomLeft,
             bottomRight
           },
+          resize: resizeWidth > 0 && resizeHeight > 0 ? {
+            width: resizeWidth,
+            height: resizeHeight
+          } : undefined,
           cache
         });
         if (!cancelled) {
@@ -81,7 +88,7 @@ function useImage({
     return () => {
       cancelled = true;
     };
-  }, [url, blur, isUniformRadius, uniformRadius, topLeft, topRight, bottomLeft, bottomRight, cache]);
+  }, [url, blur, isUniformRadius, uniformRadius, topLeft, topRight, bottomLeft, bottomRight, resizeWidth, resizeHeight, cache]);
   return image;
 }
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNativeNitroModules","NitroImagePipeline","exports","NitroModules","createHybridObject","useImage","url","blur","cornerRadius","cache","image","setImage","useState","undefined","error","loadedUrlRef","useRef","isUniformRadius","uniformRadius","topLeft","topRight","bottomLeft","bottomRight","useEffect","cancelled","current","result","loadImage","e","Error"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,wBAAA,GAAAD,OAAA;AAWO,MAAME,kBAAkB,GAAAC,OAAA,CAAAD,kBAAA,GAC7BE,qCAAY,CAACC,kBAAkB,CAAyB,oBAAoB,CAAC;AAmB/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,QAAQA,CAAC;EACvBC,GAAG;EACHC,IAAI,GAAG,CAAC;EACRC,YAAY,GAAG,CAAC;EAChBC;AAgBF,CAAC,EAAU;EACT,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAG,IAAAC,eAAQ,EAAS;IACzCF,KAAK,EAAEG,SAAS;IAChBC,KAAK,EAAED;EACT,CAAC,CAAC;EACF,MAAME,YAAY,GAAG,IAAAC,aAAM,EAACV,GAAG,CAAC;;EAEhC;EACA;EACA,MAAMW,eAAe,GAAG,OAAOT,YAAY,KAAK,QAAQ;EACxD,MAAMU,aAAa,GAAGD,eAAe,GAAGT,YAAY,GAAG,CAAC;EACxD,MAAM;IACJW,OAAO,GAAG,CAAC;IACXC,QAAQ,GAAG,CAAC;IACZC,UAAU,GAAG,CAAC;IACdC,WAAW,GAAG;EAChB,CAAC,GAAGL,eAAe,GAAG,CAAC,CAAC,GAAGT,YAAY;EAEvC,IAAAe,gBAAS,EAAC,MAAM;IACd,IAAIC,SAAS,GAAG,KAAK;IACrB;IACA;IACA;IACA,IAAIT,YAAY,CAACU,OAAO,KAAKnB,GAAG,EAAE;MAChCS,YAAY,CAACU,OAAO,GAAGnB,GAAG;MAC1BK,QAAQ,CAAC;QAAED,KAAK,EAAEG,SAAS;QAAEC,KAAK,EAAED;MAAU,CAAC,CAAC;IAClD;IAEA,CAAC,YAAY;MACX,IAAI;QACF,MAAMa,MAAM,GAAG,MAAMzB,kBAAkB,CAAC0B,SAAS,CAACrB,GAAG,EAAE;UACrDC,IAAI;UACJC,YAAY,EAAES,eAAe,GACzBC,aAAa,GACb;YAAEC,OAAO;YAAEC,QAAQ;YAAEC,UAAU;YAAEC;UAAY,CAAC;UAClDb;QACF,CAAC,CAAC;QAEF,IAAI,CAACe,SAAS,EAAE;UACdb,QAAQ,CAAC;YAAED,KAAK,EAAEgB,MAAM;YAAEZ,KAAK,EAAED;UAAU,CAAC,CAAC;QAC/C;MACF,CAAC,CAAC,OAAOe,CAAC,EAAE;QACV,MAAMd,KAAK,GAAGc,CAAC,YAAYC,KAAK,GAAGD,CAAC,GAAG,IAAIC,KAAK,CAAC,GAAGD,CAAC,EAAE,CAAC;QACxD,IAAI,CAACJ,SAAS,EAAE;UACdb,QAAQ,CAAC;YAAED,KAAK,EAAEG,SAAS;YAAEC,KAAK,EAAEA;UAAM,CAAC,CAAC;QAC9C;MACF;IACF,CAAC,EAAE,CAAC;IAEJ,OAAO,MAAM;MACXU,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CACDlB,GAAG,EACHC,IAAI,EACJU,eAAe,EACfC,aAAa,EACbC,OAAO,EACPC,QAAQ,EACRC,UAAU,EACVC,WAAW,EACXb,KAAK,CACN,CAAC;EAEF,OAAOC,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNativeNitroModules","NitroImagePipeline","exports","NitroModules","createHybridObject","useImage","url","blur","cornerRadius","resize","cache","image","setImage","useState","undefined","error","loadedUrlRef","useRef","isUniformRadius","uniformRadius","topLeft","topRight","bottomLeft","bottomRight","resizeWidth","width","resizeHeight","height","useEffect","cancelled","current","result","loadImage","e","Error"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,wBAAA,GAAAD,OAAA;AAYO,MAAME,kBAAkB,GAAAC,OAAA,CAAAD,kBAAA,GAC7BE,qCAAY,CAACC,kBAAkB,CAAyB,oBAAoB,CAAC;AAmB/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,QAAQA,CAAC;EACvBC,GAAG;EACHC,IAAI,GAAG,CAAC;EACRC,YAAY,GAAG,CAAC;EAChBC,MAAM;EACNC;AAuBF,CAAC,EAAU;EACT,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAG,IAAAC,eAAQ,EAAS;IACzCF,KAAK,EAAEG,SAAS;IAChBC,KAAK,EAAED;EACT,CAAC,CAAC;EACF,MAAME,YAAY,GAAG,IAAAC,aAAM,EAACX,GAAG,CAAC;;EAEhC;EACA;EACA,MAAMY,eAAe,GAAG,OAAOV,YAAY,KAAK,QAAQ;EACxD,MAAMW,aAAa,GAAGD,eAAe,GAAGV,YAAY,GAAG,CAAC;EACxD,MAAM;IACJY,OAAO,GAAG,CAAC;IACXC,QAAQ,GAAG,CAAC;IACZC,UAAU,GAAG,CAAC;IACdC,WAAW,GAAG;EAChB,CAAC,GAAGL,eAAe,GAAG,CAAC,CAAC,GAAGV,YAAY;EACvC,MAAMgB,WAAW,GAAGf,MAAM,EAAEgB,KAAK,IAAI,CAAC;EACtC,MAAMC,YAAY,GAAGjB,MAAM,EAAEkB,MAAM,IAAI,CAAC;EAExC,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAIC,SAAS,GAAG,KAAK;IACrB;IACA;IACA;IACA,IAAIb,YAAY,CAACc,OAAO,KAAKxB,GAAG,EAAE;MAChCU,YAAY,CAACc,OAAO,GAAGxB,GAAG;MAC1BM,QAAQ,CAAC;QAAED,KAAK,EAAEG,SAAS;QAAEC,KAAK,EAAED;MAAU,CAAC,CAAC;IAClD;IAEA,CAAC,YAAY;MACX,IAAI;QACF,MAAMiB,MAAM,GAAG,MAAM9B,kBAAkB,CAAC+B,SAAS,CAAC1B,GAAG,EAAE;UACrDC,IAAI;UACJC,YAAY,EAAEU,eAAe,GACzBC,aAAa,GACb;YAAEC,OAAO;YAAEC,QAAQ;YAAEC,UAAU;YAAEC;UAAY,CAAC;UAClDd,MAAM,EACJe,WAAW,GAAG,CAAC,IAAIE,YAAY,GAAG,CAAC,GAC/B;YAAED,KAAK,EAAED,WAAW;YAAEG,MAAM,EAAED;UAAa,CAAC,GAC5CZ,SAAS;UACfJ;QACF,CAAC,CAAC;QAEF,IAAI,CAACmB,SAAS,EAAE;UACdjB,QAAQ,CAAC;YAAED,KAAK,EAAEoB,MAAM;YAAEhB,KAAK,EAAED;UAAU,CAAC,CAAC;QAC/C;MACF,CAAC,CAAC,OAAOmB,CAAC,EAAE;QACV,MAAMlB,KAAK,GAAGkB,CAAC,YAAYC,KAAK,GAAGD,CAAC,GAAG,IAAIC,KAAK,CAAC,GAAGD,CAAC,EAAE,CAAC;QACxD,IAAI,CAACJ,SAAS,EAAE;UACdjB,QAAQ,CAAC;YAAED,KAAK,EAAEG,SAAS;YAAEC,KAAK,EAAEA;UAAM,CAAC,CAAC;QAC9C;MACF;IACF,CAAC,EAAE,CAAC;IAEJ,OAAO,MAAM;MACXc,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CACDvB,GAAG,EACHC,IAAI,EACJW,eAAe,EACfC,aAAa,EACbC,OAAO,EACPC,QAAQ,EACRC,UAAU,EACVC,WAAW,EACXC,WAAW,EACXE,YAAY,EACZhB,KAAK,CACN,CAAC;EAEF,OAAOC,KAAK;AACd","ignoreList":[]}

package/lib/module/index.js

@@ -15,6 +15,7 @@ export function useImage({
   url,
   blur = 0,
   cornerRadius = 0,
+  resize,
   cache
 }) {
   const [image, setImage] = useState({
@@ -33,6 +34,8 @@ export function useImage({
     bottomLeft = 0,
     bottomRight = 0
   } = isUniformRadius ? {} : cornerRadius;
+  const resizeWidth = resize?.width ?? 0;
+  const resizeHeight = resize?.height ?? 0;
   useEffect(() => {
     let cancelled = false;
     // Only reset to the loading state when the URL changes; for same-URL
@@ -55,6 +58,10 @@ export function useImage({
             bottomLeft,
             bottomRight
           },
+          resize: resizeWidth > 0 && resizeHeight > 0 ? {
+            width: resizeWidth,
+            height: resizeHeight
+          } : undefined,
           cache
         });
         if (!cancelled) {
@@ -76,7 +83,7 @@ export function useImage({
     return () => {
       cancelled = true;
     };
-  }, [url, blur, isUniformRadius, uniformRadius, topLeft, topRight, bottomLeft, bottomRight, cache]);
+  }, [url, blur, isUniformRadius, uniformRadius, topLeft, topRight, bottomLeft, bottomRight, resizeWidth, resizeHeight, cache]);
   return image;
 }
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["useEffect","useRef","useState","NitroModules","NitroImagePipeline","createHybridObject","useImage","url","blur","cornerRadius","cache","image","setImage","undefined","error","loadedUrlRef","isUniformRadius","uniformRadius","topLeft","topRight","bottomLeft","bottomRight","cancelled","current","result","loadImage","e","Error"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAEnD,SAASC,YAAY,QAAQ,4BAA4B;AAWzD,OAAO,MAAMC,kBAAkB,GAC7BD,YAAY,CAACE,kBAAkB,CAAyB,oBAAoB,CAAC;AAmB/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAAC;EACvBC,GAAG;EACHC,IAAI,GAAG,CAAC;EACRC,YAAY,GAAG,CAAC;EAChBC;AAgBF,CAAC,EAAU;EACT,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGV,QAAQ,CAAS;IACzCS,KAAK,EAAEE,SAAS;IAChBC,KAAK,EAAED;EACT,CAAC,CAAC;EACF,MAAME,YAAY,GAAGd,MAAM,CAACM,GAAG,CAAC;;EAEhC;EACA;EACA,MAAMS,eAAe,GAAG,OAAOP,YAAY,KAAK,QAAQ;EACxD,MAAMQ,aAAa,GAAGD,eAAe,GAAGP,YAAY,GAAG,CAAC;EACxD,MAAM;IACJS,OAAO,GAAG,CAAC;IACXC,QAAQ,GAAG,CAAC;IACZC,UAAU,GAAG,CAAC;IACdC,WAAW,GAAG;EAChB,CAAC,GAAGL,eAAe,GAAG,CAAC,CAAC,GAAGP,YAAY;EAEvCT,SAAS,CAAC,MAAM;IACd,IAAIsB,SAAS,GAAG,KAAK;IACrB;IACA;IACA;IACA,IAAIP,YAAY,CAACQ,OAAO,KAAKhB,GAAG,EAAE;MAChCQ,YAAY,CAACQ,OAAO,GAAGhB,GAAG;MAC1BK,QAAQ,CAAC;QAAED,KAAK,EAAEE,SAAS;QAAEC,KAAK,EAAED;MAAU,CAAC,CAAC;IAClD;IAEA,CAAC,YAAY;MACX,IAAI;QACF,MAAMW,MAAM,GAAG,MAAMpB,kBAAkB,CAACqB,SAAS,CAAClB,GAAG,EAAE;UACrDC,IAAI;UACJC,YAAY,EAAEO,eAAe,GACzBC,aAAa,GACb;YAAEC,OAAO;YAAEC,QAAQ;YAAEC,UAAU;YAAEC;UAAY,CAAC;UAClDX;QACF,CAAC,CAAC;QAEF,IAAI,CAACY,SAAS,EAAE;UACdV,QAAQ,CAAC;YAAED,KAAK,EAAEa,MAAM;YAAEV,KAAK,EAAED;UAAU,CAAC,CAAC;QAC/C;MACF,CAAC,CAAC,OAAOa,CAAC,EAAE;QACV,MAAMZ,KAAK,GAAGY,CAAC,YAAYC,KAAK,GAAGD,CAAC,GAAG,IAAIC,KAAK,CAAC,GAAGD,CAAC,EAAE,CAAC;QACxD,IAAI,CAACJ,SAAS,EAAE;UACdV,QAAQ,CAAC;YAAED,KAAK,EAAEE,SAAS;YAAEC,KAAK,EAAEA;UAAM,CAAC,CAAC;QAC9C;MACF;IACF,CAAC,EAAE,CAAC;IAEJ,OAAO,MAAM;MACXQ,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CACDf,GAAG,EACHC,IAAI,EACJQ,eAAe,EACfC,aAAa,EACbC,OAAO,EACPC,QAAQ,EACRC,UAAU,EACVC,WAAW,EACXX,KAAK,CACN,CAAC;EAEF,OAAOC,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["useEffect","useRef","useState","NitroModules","NitroImagePipeline","createHybridObject","useImage","url","blur","cornerRadius","resize","cache","image","setImage","undefined","error","loadedUrlRef","isUniformRadius","uniformRadius","topLeft","topRight","bottomLeft","bottomRight","resizeWidth","width","resizeHeight","height","cancelled","current","result","loadImage","e","Error"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,SAASA,SAAS,EAAEC,MAAM,EAAEC,QAAQ,QAAQ,OAAO;AAEnD,SAASC,YAAY,QAAQ,4BAA4B;AAYzD,OAAO,MAAMC,kBAAkB,GAC7BD,YAAY,CAACE,kBAAkB,CAAyB,oBAAoB,CAAC;AAmB/E;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,QAAQA,CAAC;EACvBC,GAAG;EACHC,IAAI,GAAG,CAAC;EACRC,YAAY,GAAG,CAAC;EAChBC,MAAM;EACNC;AAuBF,CAAC,EAAU;EACT,MAAM,CAACC,KAAK,EAAEC,QAAQ,CAAC,GAAGX,QAAQ,CAAS;IACzCU,KAAK,EAAEE,SAAS;IAChBC,KAAK,EAAED;EACT,CAAC,CAAC;EACF,MAAME,YAAY,GAAGf,MAAM,CAACM,GAAG,CAAC;;EAEhC;EACA;EACA,MAAMU,eAAe,GAAG,OAAOR,YAAY,KAAK,QAAQ;EACxD,MAAMS,aAAa,GAAGD,eAAe,GAAGR,YAAY,GAAG,CAAC;EACxD,MAAM;IACJU,OAAO,GAAG,CAAC;IACXC,QAAQ,GAAG,CAAC;IACZC,UAAU,GAAG,CAAC;IACdC,WAAW,GAAG;EAChB,CAAC,GAAGL,eAAe,GAAG,CAAC,CAAC,GAAGR,YAAY;EACvC,MAAMc,WAAW,GAAGb,MAAM,EAAEc,KAAK,IAAI,CAAC;EACtC,MAAMC,YAAY,GAAGf,MAAM,EAAEgB,MAAM,IAAI,CAAC;EAExC1B,SAAS,CAAC,MAAM;IACd,IAAI2B,SAAS,GAAG,KAAK;IACrB;IACA;IACA;IACA,IAAIX,YAAY,CAACY,OAAO,KAAKrB,GAAG,EAAE;MAChCS,YAAY,CAACY,OAAO,GAAGrB,GAAG;MAC1BM,QAAQ,CAAC;QAAED,KAAK,EAAEE,SAAS;QAAEC,KAAK,EAAED;MAAU,CAAC,CAAC;IAClD;IAEA,CAAC,YAAY;MACX,IAAI;QACF,MAAMe,MAAM,GAAG,MAAMzB,kBAAkB,CAAC0B,SAAS,CAACvB,GAAG,EAAE;UACrDC,IAAI;UACJC,YAAY,EAAEQ,eAAe,GACzBC,aAAa,GACb;YAAEC,OAAO;YAAEC,QAAQ;YAAEC,UAAU;YAAEC;UAAY,CAAC;UAClDZ,MAAM,EACJa,WAAW,GAAG,CAAC,IAAIE,YAAY,GAAG,CAAC,GAC/B;YAAED,KAAK,EAAED,WAAW;YAAEG,MAAM,EAAED;UAAa,CAAC,GAC5CX,SAAS;UACfH;QACF,CAAC,CAAC;QAEF,IAAI,CAACgB,SAAS,EAAE;UACdd,QAAQ,CAAC;YAAED,KAAK,EAAEiB,MAAM;YAAEd,KAAK,EAAED;UAAU,CAAC,CAAC;QAC/C;MACF,CAAC,CAAC,OAAOiB,CAAC,EAAE;QACV,MAAMhB,KAAK,GAAGgB,CAAC,YAAYC,KAAK,GAAGD,CAAC,GAAG,IAAIC,KAAK,CAAC,GAAGD,CAAC,EAAE,CAAC;QACxD,IAAI,CAACJ,SAAS,EAAE;UACdd,QAAQ,CAAC;YAAED,KAAK,EAAEE,SAAS;YAAEC,KAAK,EAAEA;UAAM,CAAC,CAAC;QAC9C;MACF;IACF,CAAC,EAAE,CAAC;IAEJ,OAAO,MAAM;MACXY,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CACDpB,GAAG,EACHC,IAAI,EACJS,eAAe,EACfC,aAAa,EACbC,OAAO,EACPC,QAAQ,EACRC,UAAU,EACVC,WAAW,EACXC,WAAW,EACXE,YAAY,EACZd,KAAK,CACN,CAAC;EAEF,OAAOC,KAAK;AACd","ignoreList":[]}

package/lib/typescript/src/index.d.ts

@@ -1,6 +1,6 @@
 import type { Image } from 'react-native-nitro-image';
-import type { CacheOption, CornerRadii, NitroImagePipeline as NitroImagePipelineSpec, Options } from './specs/nitro-image-toolkit.nitro';
-export type { CacheOption, CornerRadii, Options };
+import type { CacheOption, CornerRadii, NitroImagePipeline as NitroImagePipelineSpec, Options, ResizeOptions } from './specs/nitro-image-toolkit.nitro';
+export type { CacheOption, CornerRadii, Options, ResizeOptions };
 export declare const NitroImagePipeline: NitroImagePipelineSpec;
 type Result = {
     image: undefined;
@@ -20,20 +20,27 @@ type Result = {
  * const { image, error } = useImage({ filePath: '/tmp/image.jpg' })
  * ```
  */
-export declare function useImage({ url, blur, cornerRadius, cache, }: {
+export declare function useImage({ url, blur, cornerRadius, resize, cache, }: {
     url: string;
     /**
      * Gaussian blur strength, as the standard deviation (sigma) of the blur in
-     * source-image pixels. Matches across iOS and Android; roughly half of
-     * React Native's `blurRadius`.
+     * source-image pixels (of the resized bitmap when `resize` is set). Matches
+     * across iOS and Android; roughly half of React Native's `blurRadius`.
      */
     blur?: number;
     /**
-     * Corner radius in points, baked into the loaded bitmap. Pass a single
-     * number for uniform rounding, or per-corner radii (inline object literals
-     * are fine — the hook compares the radii by value, not identity).
+     * Corner radius in pixels of the loaded bitmap. Pass a single number for
+     * uniform rounding, or per-corner radii (inline object literals are fine —
+     * the hook compares the radii by value, not identity). Pair with `resize`
+     * so the radii apply at the size you display instead of the source size.
      */
     cornerRadius?: number | CornerRadii;
+    /**
+     * Resize the bitmap to exactly this size in pixels (aspect-fill,
+     * center-crop) before blur/rounding. Typically your display size in points
+     * multiplied by `PixelRatio.get()`. Inline object literals are fine.
+     */
+    resize?: ResizeOptions;
     cache?: CacheOption;
 }): Result;
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/src/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,IAAI,sBAAsB,EAC5C,OAAO,EACR,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,CAAC;AAElD,eAAO,MAAM,kBAAkB,wBACgD,CAAC;AAEhF,KAAK,MAAM,GAEP;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB,GAED;IACE,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB,GAED;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EACvB,GAAG,EACH,IAAQ,EACR,YAAgB,EAChB,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;OAIG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,MAAM,CAiET"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAGtD,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,kBAAkB,IAAI,sBAAsB,EAC5C,OAAO,EACP,aAAa,EACd,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,OAAO,EAAE,aAAa,EAAE,CAAC;AAEjE,eAAO,MAAM,kBAAkB,wBACgD,CAAC;AAEhF,KAAK,MAAM,GAEP;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,SAAS,CAAC;CAClB,GAED;IACE,KAAK,EAAE,KAAK,CAAC;IACb,KAAK,EAAE,SAAS,CAAC;CAClB,GAED;IACE,KAAK,EAAE,SAAS,CAAC;IACjB,KAAK,EAAE,KAAK,CAAC;CACd,CAAC;AAEN;;;;;;;GAOG;AACH,wBAAgB,QAAQ,CAAC,EACvB,GAAG,EACH,IAAQ,EACR,YAAgB,EAChB,MAAM,EACN,KAAK,GACN,EAAE;IACD,GAAG,EAAE,MAAM,CAAC;IACZ;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;OAKG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC;;;;OAIG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IACvB,KAAK,CAAC,EAAE,WAAW,CAAC;CACrB,GAAG,MAAM,CAyET"}

package/lib/typescript/src/specs/nitro-image-toolkit.nitro.d.ts

@@ -2,7 +2,8 @@ import type { Image } from 'react-native-nitro-image';
 import type { HybridObject } from 'react-native-nitro-modules';
 export type CacheOption = 'memory' | 'disk' | 'none';
 /**
- * Independent corner radii in points. Omitted corners stay square.
+ * Independent corner radii, in pixels of the loaded bitmap (see
+ * {@linkcode Options.cornerRadius}). Omitted corners stay square.
  */
 export interface CornerRadii {
     topLeft?: number;
@@ -10,12 +11,24 @@ export interface CornerRadii {
     bottomLeft?: number;
     bottomRight?: number;
 }
+/**
+ * Target bitmap size in pixels. The image is scaled to fill this size and
+ * center-cropped (like CSS `object-fit: cover`), upscaling if needed, so the
+ * result is exactly `width` × `height` pixels.
+ */
+export interface ResizeOptions {
+    width: number;
+    height: number;
+}
 export type Options = {
     /**
      * Gaussian blur strength, given as the standard deviation (sigma) of the
      * blur in **source-image pixels**. The same value on the same source image
      * produces the same result on iOS and Android.
      *
+     * When {@linkcode resize} is set, the blur runs after resizing, so sigma is
+     * in pixels of the resized bitmap instead.
+     *
      * React Native's `<Image blurRadius={n} />` is roughly `blur: n / 2`.
      *
      * @default 0 (no blur)
@@ -23,14 +36,29 @@ export type Options = {
     blur?: number;
     cache?: CacheOption;
     /**
-     * Corner radius in points, baked into the loaded bitmap. Pass a single
-     * number to round all four corners uniformly, or a {@linkcode CornerRadii}
-     * object to round each corner independently (e.g. a "ticket" shape with
-     * larger bottom corners).
+     * Corner radius baked into the loaded bitmap, in **pixels of that bitmap**.
+     * Pass a single number to round all four corners uniformly, or a
+     * {@linkcode CornerRadii} object to round each corner independently (e.g. a
+     * "ticket" shape with larger bottom corners).
+     *
+     * Without {@linkcode resize} the radius applies to the full-resolution
+     * source image, so on a large photo displayed small the rounding shrinks
+     * along with it. To get corners sized for your layout, pass `resize` with
+     * your display size in pixels (points × screen scale) — the radii then
+     * apply to that final bitmap, 1:1 with what you see.
      *
      * @default 0 (square corners)
      */
     cornerRadius?: number | CornerRadii;
+    /**
+     * Resize the image to exactly this size in pixels (aspect-fill,
+     * center-crop) before `blur` and `cornerRadius` are applied. Besides making
+     * `cornerRadius` predictable, this avoids decoding and processing
+     * full-resolution bitmaps you only display small.
+     *
+     * @default undefined (keep the source size)
+     */
+    resize?: ResizeOptions;
 };
 export interface NitroImagePipeline extends HybridObject<{
     ios: 'swift';

package/lib/typescript/src/specs/nitro-image-toolkit.nitro.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"nitro-image-toolkit.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-image-toolkit.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,OAAO,GAAG;IACpB;;;;;;;;OAQG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;;;;OAOG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;CACrC,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,YAAY,CAAC;IACvD,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;IACA,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAG3D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}
+{"version":3,"file":"nitro-image-toolkit.nitro.d.ts","sourceRoot":"","sources":["../../../../src/specs/nitro-image-toolkit.nitro.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE/D,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,CAAC;AAErD;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,OAAO,GAAG;IACpB;;;;;;;;;;;OAWG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;;;;;;;;;;OAaG;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,WAAW,CAAC;IACpC;;;;;;;OAOG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB,CAAC;AAEF,MAAM,WAAW,kBAAmB,SAAQ,YAAY,CAAC;IACvD,GAAG,EAAE,OAAO,CAAC;IACb,OAAO,EAAE,QAAQ,CAAC;CACnB,CAAC;IACA,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAC1D,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACzC,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C;;;;OAIG;IACH,YAAY,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAG3D,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/nitrogen/generated/android/c++/JHybridNitroImagePipelineSpec.cpp

@@ -15,6 +15,8 @@ namespace margelo::nitro::nitroimagepipeline { struct Options; }
 namespace margelo::nitro::nitroimagepipeline { enum class CacheOption; }
 // Forward declaration of `CornerRadii` to properly resolve imports.
 namespace margelo::nitro::nitroimagepipeline { struct CornerRadii; }
+// Forward declaration of `ResizeOptions` to properly resolve imports.
+namespace margelo::nitro::nitroimagepipeline { struct ResizeOptions; }
 
 #include <memory>
 #include <NitroImage/HybridImageSpec.hpp>
@@ -32,6 +34,8 @@ namespace margelo::nitro::nitroimagepipeline { struct CornerRadii; }
 #include <variant>
 #include "JVariant_Double_CornerRadii.hpp"
 #include "JCornerRadii.hpp"
+#include "ResizeOptions.hpp"
+#include "JResizeOptions.hpp"
 #include <vector>
 
 namespace margelo::nitro::nitroimagepipeline {

package/nitrogen/generated/android/c++/JOptions.hpp

@@ -14,7 +14,9 @@
 #include "CornerRadii.hpp"
 #include "JCacheOption.hpp"
 #include "JCornerRadii.hpp"
+#include "JResizeOptions.hpp"
 #include "JVariant_Double_CornerRadii.hpp"
+#include "ResizeOptions.hpp"
 #include <optional>
 #include <variant>
 
@@ -43,10 +45,13 @@ namespace margelo::nitro::nitroimagepipeline {
       jni::local_ref<JCacheOption> cache = this->getFieldValue(fieldCache);
       static const auto fieldCornerRadius = clazz->getField<JVariant_Double_CornerRadii>("cornerRadius");
       jni::local_ref<JVariant_Double_CornerRadii> cornerRadius = this->getFieldValue(fieldCornerRadius);
+      static const auto fieldResize = clazz->getField<JResizeOptions>("resize");
+      jni::local_ref<JResizeOptions> resize = this->getFieldValue(fieldResize);
       return Options(
         blur != nullptr ? std::make_optional(blur->value()) : std::nullopt,
         cache != nullptr ? std::make_optional(cache->toCpp()) : std::nullopt,
-        cornerRadius != nullptr ? std::make_optional(cornerRadius->toCpp()) : std::nullopt
+        cornerRadius != nullptr ? std::make_optional(cornerRadius->toCpp()) : std::nullopt,
+        resize != nullptr ? std::make_optional(resize->toCpp()) : std::nullopt
       );
     }
 
@@ -56,14 +61,15 @@ namespace margelo::nitro::nitroimagepipeline {
      */
     [[maybe_unused]]
     static jni::local_ref<JOptions::javaobject> fromCpp(const Options& value) {
-      using JSignature = JOptions(jni::alias_ref<jni::JDouble>, jni::alias_ref<JCacheOption>, jni::alias_ref<JVariant_Double_CornerRadii>);
+      using JSignature = JOptions(jni::alias_ref<jni::JDouble>, jni::alias_ref<JCacheOption>, jni::alias_ref<JVariant_Double_CornerRadii>, jni::alias_ref<JResizeOptions>);
       static const auto clazz = javaClassStatic();
       static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
       return create(
         clazz,
         value.blur.has_value() ? jni::JDouble::valueOf(value.blur.value()) : nullptr,
         value.cache.has_value() ? JCacheOption::fromCpp(value.cache.value()) : nullptr,
-        value.cornerRadius.has_value() ? JVariant_Double_CornerRadii::fromCpp(value.cornerRadius.value()) : nullptr
+        value.cornerRadius.has_value() ? JVariant_Double_CornerRadii::fromCpp(value.cornerRadius.value()) : nullptr,
+        value.resize.has_value() ? JResizeOptions::fromCpp(value.resize.value()) : nullptr
       );
     }
   };

package/nitrogen/generated/android/c++/JResizeOptions.hpp

@@ -0,0 +1,61 @@
+///
+/// JResizeOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#include <fbjni/fbjni.h>
+#include "ResizeOptions.hpp"
+
+
+
+namespace margelo::nitro::nitroimagepipeline {
+
+  using namespace facebook;
+
+  /**
+   * The C++ JNI bridge between the C++ struct "ResizeOptions" and the Kotlin data class "ResizeOptions".
+   */
+  struct JResizeOptions final: public jni::JavaClass<JResizeOptions> {
+  public:
+    static constexpr auto kJavaDescriptor = "Lcom/margelo/nitro/nitroimagepipeline/ResizeOptions;";
+
+  public:
+    /**
+     * Convert this Java/Kotlin-based struct to the C++ struct ResizeOptions by copying all values to C++.
+     */
+    [[maybe_unused]]
+    [[nodiscard]]
+    ResizeOptions toCpp() const {
+      static const auto clazz = javaClassStatic();
+      static const auto fieldWidth = clazz->getField<double>("width");
+      double width = this->getFieldValue(fieldWidth);
+      static const auto fieldHeight = clazz->getField<double>("height");
+      double height = this->getFieldValue(fieldHeight);
+      return ResizeOptions(
+        width,
+        height
+      );
+    }
+
+  public:
+    /**
+     * Create a Java/Kotlin-based struct by copying all values from the given C++ struct to Java.
+     */
+    [[maybe_unused]]
+    static jni::local_ref<JResizeOptions::javaobject> fromCpp(const ResizeOptions& value) {
+      using JSignature = JResizeOptions(double, double);
+      static const auto clazz = javaClassStatic();
+      static const auto create = clazz->getStaticMethod<JSignature>("fromCpp");
+      return create(
+        clazz,
+        value.width,
+        value.height
+      );
+    }
+  };
+
+} // namespace margelo::nitro::nitroimagepipeline

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroimagepipeline/Options.kt

@@ -26,7 +26,10 @@ data class Options(
   val cache: CacheOption?,
   @DoNotStrip
   @Keep
-  val cornerRadius: Variant_Double_CornerRadii?
+  val cornerRadius: Variant_Double_CornerRadii?,
+  @DoNotStrip
+  @Keep
+  val resize: ResizeOptions?
 ) {
   /* primary constructor */
 
@@ -36,13 +39,15 @@ data class Options(
     return Objects.deepEquals(this.blur, other.blur)
       && Objects.deepEquals(this.cache, other.cache)
       && Objects.deepEquals(this.cornerRadius, other.cornerRadius)
+      && Objects.deepEquals(this.resize, other.resize)
   }
 
   override fun hashCode(): Int {
     return arrayOf<Any?>(
       blur,
       cache,
-      cornerRadius
+      cornerRadius,
+      resize
     ).contentDeepHashCode()
   }
 
@@ -54,8 +59,8 @@ data class Options(
     @Keep
     @Suppress("unused")
     @JvmStatic
-    private fun fromCpp(blur: Double?, cache: CacheOption?, cornerRadius: Variant_Double_CornerRadii?): Options {
-      return Options(blur, cache, cornerRadius)
+    private fun fromCpp(blur: Double?, cache: CacheOption?, cornerRadius: Variant_Double_CornerRadii?, resize: ResizeOptions?): Options {
+      return Options(blur, cache, cornerRadius, resize)
     }
   }
 }

package/nitrogen/generated/android/kotlin/com/margelo/nitro/nitroimagepipeline/ResizeOptions.kt

@@ -0,0 +1,56 @@
+///
+/// ResizeOptions.kt
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+package com.margelo.nitro.nitroimagepipeline
+
+import androidx.annotation.Keep
+import com.facebook.proguard.annotations.DoNotStrip
+import java.util.Objects
+
+
+/**
+ * Represents the JavaScript object/struct "ResizeOptions".
+ */
+@DoNotStrip
+@Keep
+data class ResizeOptions(
+  @DoNotStrip
+  @Keep
+  val width: Double,
+  @DoNotStrip
+  @Keep
+  val height: Double
+) {
+  /* primary constructor */
+
+  override fun equals(other: Any?): Boolean {
+    if (this === other) return true
+    if (other !is ResizeOptions) return false
+    return Objects.deepEquals(this.width, other.width)
+      && Objects.deepEquals(this.height, other.height)
+  }
+
+  override fun hashCode(): Int {
+    return arrayOf<Any?>(
+      width,
+      height
+    ).contentDeepHashCode()
+  }
+
+  companion object {
+    /**
+     * Constructor called from C++
+     */
+    @DoNotStrip
+    @Keep
+    @Suppress("unused")
+    @JvmStatic
+    private fun fromCpp(width: Double, height: Double): ResizeOptions {
+      return ResizeOptions(width, height)
+    }
+  }
+}

package/nitrogen/generated/ios/NitroImagePipeline-Swift-Cxx-Bridge.hpp

@@ -18,6 +18,8 @@ namespace margelo::nitro::image { class HybridImageSpec; }
 namespace margelo::nitro::nitroimagepipeline { class HybridNitroImagePipelineSpec; }
 // Forward declaration of `Options` to properly resolve imports.
 namespace margelo::nitro::nitroimagepipeline { struct Options; }
+// Forward declaration of `ResizeOptions` to properly resolve imports.
+namespace margelo::nitro::nitroimagepipeline { struct ResizeOptions; }
 
 // Forward declarations of Swift defined types
 // Forward declaration of `HybridImageSpec_cxx` to properly resolve imports.
@@ -30,6 +32,7 @@ namespace NitroImagePipeline { class HybridNitroImagePipelineSpec_cxx; }
 #include "CornerRadii.hpp"
 #include "HybridNitroImagePipelineSpec.hpp"
 #include "Options.hpp"
+#include "ResizeOptions.hpp"
 #include <NitroImage/HybridImageSpec.hpp>
 #include <NitroModules/Promise.hpp>
 #include <NitroModules/PromiseHolder.hpp>
@@ -190,6 +193,21 @@ namespace margelo::nitro::nitroimagepipeline::bridge::swift {
     return optional.value();
   }
   
+  // pragma MARK: std::optional<ResizeOptions>
+  /**
+   * Specialized version of `std::optional<ResizeOptions>`.
+   */
+  using std__optional_ResizeOptions_ = std::optional<ResizeOptions>;
+  inline std::optional<ResizeOptions> create_std__optional_ResizeOptions_(const ResizeOptions& value) noexcept {
+    return std::optional<ResizeOptions>(value);
+  }
+  inline bool has_value_std__optional_ResizeOptions_(const std::optional<ResizeOptions>& optional) noexcept {
+    return optional.has_value();
+  }
+  inline ResizeOptions get_std__optional_ResizeOptions_(const std::optional<ResizeOptions>& optional) noexcept {
+    return optional.value();
+  }
+  
   // pragma MARK: std::optional<Options>
   /**
    * Specialized version of `std::optional<Options>`.

package/nitrogen/generated/ios/NitroImagePipeline-Swift-Cxx-Umbrella.hpp

@@ -18,12 +18,15 @@ namespace margelo::nitro::image { class HybridImageSpec; }
 namespace margelo::nitro::nitroimagepipeline { class HybridNitroImagePipelineSpec; }
 // Forward declaration of `Options` to properly resolve imports.
 namespace margelo::nitro::nitroimagepipeline { struct Options; }
+// Forward declaration of `ResizeOptions` to properly resolve imports.
+namespace margelo::nitro::nitroimagepipeline { struct ResizeOptions; }
 
 // Include C++ defined types
 #include "CacheOption.hpp"
 #include "CornerRadii.hpp"
 #include "HybridNitroImagePipelineSpec.hpp"
 #include "Options.hpp"
+#include "ResizeOptions.hpp"
 #include <NitroImage/HybridImageSpec.hpp>
 #include <NitroModules/Promise.hpp>
 #include <NitroModules/Result.hpp>

package/nitrogen/generated/ios/c++/HybridNitroImagePipelineSpecSwift.hpp

@@ -20,6 +20,8 @@ namespace margelo::nitro::nitroimagepipeline { struct Options; }
 namespace margelo::nitro::nitroimagepipeline { enum class CacheOption; }
 // Forward declaration of `CornerRadii` to properly resolve imports.
 namespace margelo::nitro::nitroimagepipeline { struct CornerRadii; }
+// Forward declaration of `ResizeOptions` to properly resolve imports.
+namespace margelo::nitro::nitroimagepipeline { struct ResizeOptions; }
 
 #include <memory>
 #include <NitroImage/HybridImageSpec.hpp>
@@ -30,6 +32,7 @@ namespace margelo::nitro::nitroimagepipeline { struct CornerRadii; }
 #include "CacheOption.hpp"
 #include "CornerRadii.hpp"
 #include <variant>
+#include "ResizeOptions.hpp"
 #include <vector>
 
 #include "NitroImagePipeline-Swift-Cxx-Umbrella.hpp"

package/nitrogen/generated/ios/swift/Options.swift

@@ -18,7 +18,7 @@ public extension Options {
   /**
    * Create a new instance of `Options`.
    */
-  init(blur: Double?, cache: CacheOption?, cornerRadius: Variant_Double_CornerRadii?) {
+  init(blur: Double?, cache: CacheOption?, cornerRadius: Variant_Double_CornerRadii?, resize: ResizeOptions?) {
     self.init({ () -> bridge.std__optional_double_ in
       if let __unwrappedValue = blur {
         return bridge.create_std__optional_double_(__unwrappedValue)
@@ -44,6 +44,12 @@ public extension Options {
       } else {
         return .init()
       }
+    }(), { () -> bridge.std__optional_ResizeOptions_ in
+      if let __unwrappedValue = resize {
+        return bridge.create_std__optional_ResizeOptions_(__unwrappedValue)
+      } else {
+        return .init()
+      }
     }())
   }
 
@@ -87,4 +93,9 @@ public extension Options {
       }
     }()
   }
+  
+  @inline(__always)
+  var resize: ResizeOptions? {
+    return self.__resize.value
+  }
 }

package/nitrogen/generated/ios/swift/ResizeOptions.swift

@@ -0,0 +1,34 @@
+///
+/// ResizeOptions.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+import NitroModules
+
+/**
+ * Represents an instance of `ResizeOptions`, backed by a C++ struct.
+ */
+public typealias ResizeOptions = margelo.nitro.nitroimagepipeline.ResizeOptions
+
+public extension ResizeOptions {
+  private typealias bridge = margelo.nitro.nitroimagepipeline.bridge.swift
+
+  /**
+   * Create a new instance of `ResizeOptions`.
+   */
+  init(width: Double, height: Double) {
+    self.init(width, height)
+  }
+
+  @inline(__always)
+  var width: Double {
+    return self.__width
+  }
+  
+  @inline(__always)
+  var height: Double {
+    return self.__height
+  }
+}

package/nitrogen/generated/shared/c++/Options.hpp

@@ -32,11 +32,14 @@
 namespace margelo::nitro::nitroimagepipeline { enum class CacheOption; }
 // Forward declaration of `CornerRadii` to properly resolve imports.
 namespace margelo::nitro::nitroimagepipeline { struct CornerRadii; }
+// Forward declaration of `ResizeOptions` to properly resolve imports.
+namespace margelo::nitro::nitroimagepipeline { struct ResizeOptions; }
 
 #include <optional>
 #include "CacheOption.hpp"
 #include "CornerRadii.hpp"
 #include <variant>
+#include "ResizeOptions.hpp"
 
 namespace margelo::nitro::nitroimagepipeline {
 
@@ -48,10 +51,11 @@ namespace margelo::nitro::nitroimagepipeline {
     std::optional<double> blur     SWIFT_PRIVATE;
     std::optional<CacheOption> cache     SWIFT_PRIVATE;
     std::optional<std::variant<double, CornerRadii>> cornerRadius     SWIFT_PRIVATE;
+    std::optional<ResizeOptions> resize     SWIFT_PRIVATE;
 
   public:
     Options() = default;
-    explicit Options(std::optional<double> blur, std::optional<CacheOption> cache, std::optional<std::variant<double, CornerRadii>> cornerRadius): blur(blur), cache(cache), cornerRadius(cornerRadius) {}
+    explicit Options(std::optional<double> blur, std::optional<CacheOption> cache, std::optional<std::variant<double, CornerRadii>> cornerRadius, std::optional<ResizeOptions> resize): blur(blur), cache(cache), cornerRadius(cornerRadius), resize(resize) {}
 
   public:
     friend bool operator==(const Options& lhs, const Options& rhs) = default;
@@ -69,7 +73,8 @@ namespace margelo::nitro {
       return margelo::nitro::nitroimagepipeline::Options(
         JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "blur"))),
         JSIConverter<std::optional<margelo::nitro::nitroimagepipeline::CacheOption>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cache"))),
-        JSIConverter<std::optional<std::variant<double, margelo::nitro::nitroimagepipeline::CornerRadii>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius")))
+        JSIConverter<std::optional<std::variant<double, margelo::nitro::nitroimagepipeline::CornerRadii>>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius"))),
+        JSIConverter<std::optional<margelo::nitro::nitroimagepipeline::ResizeOptions>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "resize")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroimagepipeline::Options& arg) {
@@ -77,6 +82,7 @@ namespace margelo::nitro {
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "blur"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.blur));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "cache"), JSIConverter<std::optional<margelo::nitro::nitroimagepipeline::CacheOption>>::toJSI(runtime, arg.cache));
       obj.setProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius"), JSIConverter<std::optional<std::variant<double, margelo::nitro::nitroimagepipeline::CornerRadii>>>::toJSI(runtime, arg.cornerRadius));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "resize"), JSIConverter<std::optional<margelo::nitro::nitroimagepipeline::ResizeOptions>>::toJSI(runtime, arg.resize));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -90,6 +96,7 @@ namespace margelo::nitro {
       if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "blur")))) return false;
       if (!JSIConverter<std::optional<margelo::nitro::nitroimagepipeline::CacheOption>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cache")))) return false;
       if (!JSIConverter<std::optional<std::variant<double, margelo::nitro::nitroimagepipeline::CornerRadii>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius")))) return false;
+      if (!JSIConverter<std::optional<margelo::nitro::nitroimagepipeline::ResizeOptions>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "resize")))) return false;
       return true;
     }
   };

package/nitrogen/generated/shared/c++/ResizeOptions.hpp

@@ -0,0 +1,87 @@
+///
+/// ResizeOptions.hpp
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+#pragma once
+
+#if __has_include(<NitroModules/JSIConverter.hpp>)
+#include <NitroModules/JSIConverter.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/NitroDefines.hpp>)
+#include <NitroModules/NitroDefines.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/JSIHelpers.hpp>)
+#include <NitroModules/JSIHelpers.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+#if __has_include(<NitroModules/PropNameIDCache.hpp>)
+#include <NitroModules/PropNameIDCache.hpp>
+#else
+#error NitroModules cannot be found! Are you sure you installed NitroModules properly?
+#endif
+
+
+
+
+
+namespace margelo::nitro::nitroimagepipeline {
+
+  /**
+   * A struct which can be represented as a JavaScript object (ResizeOptions).
+   */
+  struct ResizeOptions final {
+  public:
+    double width     SWIFT_PRIVATE;
+    double height     SWIFT_PRIVATE;
+
+  public:
+    ResizeOptions() = default;
+    explicit ResizeOptions(double width, double height): width(width), height(height) {}
+
+  public:
+    friend bool operator==(const ResizeOptions& lhs, const ResizeOptions& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitroimagepipeline
+
+namespace margelo::nitro {
+
+  // C++ ResizeOptions <> JS ResizeOptions (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroimagepipeline::ResizeOptions> final {
+    static inline margelo::nitro::nitroimagepipeline::ResizeOptions fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroimagepipeline::ResizeOptions(
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width"))),
+        JSIConverter<double>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroimagepipeline::ResizeOptions& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "width"), JSIConverter<double>::toJSI(runtime, arg.width));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "height"), JSIConverter<double>::toJSI(runtime, arg.height));
+      return obj;
+    }
+    static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
+      if (!value.isObject()) {
+        return false;
+      }
+      jsi::Object obj = value.getObject(runtime);
+      if (!nitro::isPlainObject(runtime, obj)) {
+        return false;
+      }
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "width")))) return false;
+      if (!JSIConverter<double>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "height")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-image-pipeline",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "High-performance image loading, caching, and processing for React Native, built with Nitro Modules",
   "main": "./lib/commonjs/index.js",
   "module": "./lib/module/index.js",

package/src/index.ts

@@ -7,9 +7,10 @@ import type {
   CornerRadii,
   NitroImagePipeline as NitroImagePipelineSpec,
   Options,
+  ResizeOptions,
 } from './specs/nitro-image-toolkit.nitro';
 
-export type { CacheOption, CornerRadii, Options };
+export type { CacheOption, CornerRadii, Options, ResizeOptions };
 
 export const NitroImagePipeline =
   NitroModules.createHybridObject<NitroImagePipelineSpec>('NitroImagePipeline');
@@ -43,21 +44,29 @@ export function useImage({
   url,
   blur = 0,
   cornerRadius = 0,
+  resize,
   cache,
 }: {
   url: string;
   /**
    * Gaussian blur strength, as the standard deviation (sigma) of the blur in
-   * source-image pixels. Matches across iOS and Android; roughly half of
-   * React Native's `blurRadius`.
+   * source-image pixels (of the resized bitmap when `resize` is set). Matches
+   * across iOS and Android; roughly half of React Native's `blurRadius`.
    */
   blur?: number;
   /**
-   * Corner radius in points, baked into the loaded bitmap. Pass a single
-   * number for uniform rounding, or per-corner radii (inline object literals
-   * are fine — the hook compares the radii by value, not identity).
+   * Corner radius in pixels of the loaded bitmap. Pass a single number for
+   * uniform rounding, or per-corner radii (inline object literals are fine —
+   * the hook compares the radii by value, not identity). Pair with `resize`
+   * so the radii apply at the size you display instead of the source size.
    */
   cornerRadius?: number | CornerRadii;
+  /**
+   * Resize the bitmap to exactly this size in pixels (aspect-fill,
+   * center-crop) before blur/rounding. Typically your display size in points
+   * multiplied by `PixelRatio.get()`. Inline object literals are fine.
+   */
+  resize?: ResizeOptions;
   cache?: CacheOption;
 }): Result {
   const [image, setImage] = useState<Result>({
@@ -76,6 +85,8 @@ export function useImage({
     bottomLeft = 0,
     bottomRight = 0,
   } = isUniformRadius ? {} : cornerRadius;
+  const resizeWidth = resize?.width ?? 0;
+  const resizeHeight = resize?.height ?? 0;
 
   useEffect(() => {
     let cancelled = false;
@@ -94,6 +105,10 @@ export function useImage({
           cornerRadius: isUniformRadius
             ? uniformRadius
             : { topLeft, topRight, bottomLeft, bottomRight },
+          resize:
+            resizeWidth > 0 && resizeHeight > 0
+              ? { width: resizeWidth, height: resizeHeight }
+              : undefined,
           cache,
         });
 
@@ -120,6 +135,8 @@ export function useImage({
     topRight,
     bottomLeft,
     bottomRight,
+    resizeWidth,
+    resizeHeight,
     cache,
   ]);
 

package/src/specs/nitro-image-toolkit.nitro.ts

@@ -4,7 +4,8 @@ import type { HybridObject } from 'react-native-nitro-modules';
 export type CacheOption = 'memory' | 'disk' | 'none';
 
 /**
- * Independent corner radii in points. Omitted corners stay square.
+ * Independent corner radii, in pixels of the loaded bitmap (see
+ * {@linkcode Options.cornerRadius}). Omitted corners stay square.
  */
 export interface CornerRadii {
   topLeft?: number;
@@ -13,12 +14,25 @@ export interface CornerRadii {
   bottomRight?: number;
 }
 
+/**
+ * Target bitmap size in pixels. The image is scaled to fill this size and
+ * center-cropped (like CSS `object-fit: cover`), upscaling if needed, so the
+ * result is exactly `width` × `height` pixels.
+ */
+export interface ResizeOptions {
+  width: number;
+  height: number;
+}
+
 export type Options = {
   /**
    * Gaussian blur strength, given as the standard deviation (sigma) of the
    * blur in **source-image pixels**. The same value on the same source image
    * produces the same result on iOS and Android.
    *
+   * When {@linkcode resize} is set, the blur runs after resizing, so sigma is
+   * in pixels of the resized bitmap instead.
+   *
    * React Native's `<Image blurRadius={n} />` is roughly `blur: n / 2`.
    *
    * @default 0 (no blur)
@@ -26,14 +40,29 @@ export type Options = {
   blur?: number;
   cache?: CacheOption;
   /**
-   * Corner radius in points, baked into the loaded bitmap. Pass a single
-   * number to round all four corners uniformly, or a {@linkcode CornerRadii}
-   * object to round each corner independently (e.g. a "ticket" shape with
-   * larger bottom corners).
+   * Corner radius baked into the loaded bitmap, in **pixels of that bitmap**.
+   * Pass a single number to round all four corners uniformly, or a
+   * {@linkcode CornerRadii} object to round each corner independently (e.g. a
+   * "ticket" shape with larger bottom corners).
+   *
+   * Without {@linkcode resize} the radius applies to the full-resolution
+   * source image, so on a large photo displayed small the rounding shrinks
+   * along with it. To get corners sized for your layout, pass `resize` with
+   * your display size in pixels (points × screen scale) — the radii then
+   * apply to that final bitmap, 1:1 with what you see.
    *
    * @default 0 (square corners)
    */
   cornerRadius?: number | CornerRadii;
+  /**
+   * Resize the image to exactly this size in pixels (aspect-fill,
+   * center-crop) before `blur` and `cornerRadius` are applied. Besides making
+   * `cornerRadius` predictable, this avoids decoding and processing
+   * full-resolution bitmaps you only display small.
+   *
+   * @default undefined (keep the source size)
+   */
+  resize?: ResizeOptions;
 };
 
 export interface NitroImagePipeline extends HybridObject<{