react-native-nitro-image-pipeline 1.5.0 → 1.7.0

package/ios/PipelineImageLoader.swift

@@ -21,6 +21,11 @@ import UIKit
 /// `ViewOptions` values are in points; this class converts them to the
 /// pixel-based `Options` of the shared request builder using the view's
 /// display scale, so cache keys match an equivalent `loadImage` call.
+///
+/// The optional `onLoad`/`onError` callbacks report a view's load back to JS.
+/// They are per request, not per loader: several views (and a recycled cell
+/// re-attaching) each call them, and a view that requests twice reports twice.
+/// `loadImage()` doesn't — it reports through its promise instead.
 class PipelineImageLoader: HybridImageLoaderSpec {
     private let url: String
     private let options: ViewOptions?
@@ -30,6 +35,14 @@ class PipelineImageLoader: HybridImageLoaderSpec {
     // to the main thread — every access happens inside a main-queue block.
     private var tasks: [ObjectIdentifier: Task<Void, Never>] = [:]
     private var pendingLayouts: [ObjectIdentifier: NSKeyValueObservation] = [:]
+    // Bumped synchronously by every `requestImage`/`dropImage` — the view
+    // calls both on the main thread, from its own lifecycle — so work queued
+    // by an earlier call can tell a later one superseded it before its
+    // main-queue block ran, and neither displays nor reports. `dropImage`
+    // only *queues* its cancellation, so without this a request queued just
+    // before a detach still runs first and, on a memory-cache hit, reports a
+    // load for a view that is about to be cleared.
+    private var generations: [ObjectIdentifier: Int] = [:]
 
     init(url: String, options: ViewOptions?) {
         self.url = url
@@ -55,7 +68,9 @@ class PipelineImageLoader: HybridImageLoaderSpec {
     }
 
     /// The point-based `ViewOptions` as pixel-based `Options`, resolved
-    /// against `scale` and the target size in pixels.
+    /// against `scale` and the target size in pixels. The fit comes from the
+    /// explicit `resize` when it carries one, else from the top-level
+    /// `fit`/`allowUpscale`, which apply to the measured size.
     private func pixelOptions(scale: CGFloat, sizePx: CGSize?) -> Options {
         let cornerRadius = options?.cornerRadius.map { radius -> Variant_Double_CornerRadii in
             switch radius {
@@ -74,23 +89,50 @@ class PipelineImageLoader: HybridImageLoaderSpec {
             blur: options?.blur.map { $0 * scale },
             cache: options?.cache,
             cornerRadius: cornerRadius,
-            resize: sizePx.map { ResizeOptions(width: Double($0.width), height: Double($0.height)) }
+            resize: sizePx.map {
+                ResizeOptions(
+                    width: Double($0.width),
+                    height: Double($0.height),
+                    fit: explicitResizeOptions?.fit ?? options?.fit,
+                    allowUpscale: explicitResizeOptions?.allowUpscale ?? options?.allowUpscale
+                )
+            }
         )
     }
 
-    /// An explicit `resize` override (pixels), when set and valid.
-    private var explicitResize: CGSize? {
+    /// The loaded image as the view should draw it. The pipeline decodes at
+    /// scale 1 (1 pt = 1 px); `.center` — the one content mode that draws an
+    /// image at its point size — would then show a `fit: 'center'` bitmap at
+    /// `scale`× its size on a Retina screen, while Android's
+    /// `ScaleType.CENTER` draws it pixel for pixel. Re-wrapping with the
+    /// display scale (a wrapper around the same CGImage, not a copy) makes
+    /// iOS draw 1 bitmap pixel per device pixel too; the scaling content
+    /// modes are unaffected by an image's scale.
+    private static func displayImage(_ image: UIImage, scale: CGFloat) -> UIImage {
+        guard image.scale != scale, let cgImage = image.cgImage else { return image }
+        return UIImage(cgImage: cgImage, scale: scale, orientation: image.imageOrientation)
+    }
+
+    /// The explicit `resize` override, when set and valid. An invalid one
+    /// (a non-positive dimension) is ignored as a whole — its `fit` and
+    /// `allowUpscale` included, as on Android — and the view is measured.
+    private var explicitResizeOptions: ResizeOptions? {
         guard let resize = options?.resize, resize.width > 0, resize.height > 0 else {
             return nil
         }
-        return CGSize(width: resize.width, height: resize.height)
+        return resize
+    }
+
+    /// The explicit `resize` override's size (pixels), when set and valid.
+    private var explicitResize: CGSize? {
+        explicitResizeOptions.map { CGSize(width: $0.width, height: $0.height) }
     }
 
     // MARK: - ImageLoader
 
     func loadImage() throws -> Promise<any HybridImageSpec> {
         return Promise.async {
-            guard let imageUrl = URL(string: self.url) else {
+            guard let imageUrl = HybridNitroImagePipeline.url(from: self.url) else {
                 throw RuntimeError.error(withMessage: "Invalid URL: \(self.url)")
             }
             // No view to measure here: use the explicit resize if given, and
@@ -108,17 +150,22 @@ class PipelineImageLoader: HybridImageLoaderSpec {
     func requestImage(forView view: any HybridNitroImageViewSpec) throws {
         guard let nativeView = view as? NativeImageView else { return }
         let key = ObjectIdentifier(view)
+        let generation = supersedeWork(for: key)
         // Always hop (asynchronously) to main: `requestImage` fires while the
         // view is being mounted, and only after the current mounting
         // transaction finishes is its final frame guaranteed to be set.
         DispatchQueue.main.async {
-            self.load(into: nativeView.imageView, key: key)
+            guard self.isCurrent(generation, for: key) else { return }
+            self.load(into: nativeView.imageView, key: key, generation: generation)
         }
     }
 
     func dropImage(forView view: any HybridNitroImageViewSpec) throws {
         guard let nativeView = view as? NativeImageView else { return }
         let key = ObjectIdentifier(view)
+        // Takes effect now, unlike the cancellation below: a request queued
+        // before this drop runs first, and must not load or report.
+        _ = supersedeWork(for: key)
         // Same queue as `requestImage`, so rapid attach/detach sequences
         // (list recycling) replay in call order.
         DispatchQueue.main.async {
@@ -129,6 +176,20 @@ class PipelineImageLoader: HybridImageLoaderSpec {
 
     // MARK: - Main-thread loading
 
+    /// Invalidates whatever is queued for `key` and returns the token
+    /// identifying this new piece of work. Main thread, like its callers.
+    private func supersedeWork(for key: ObjectIdentifier) -> Int {
+        // Never reset: a token must not be reused while an older block that
+        // holds it is still queued.
+        let generation = (generations[key] ?? 0) + 1
+        generations[key] = generation
+        return generation
+    }
+
+    private func isCurrent(_ generation: Int, for key: ObjectIdentifier) -> Bool {
+        return generations[key] == generation
+    }
+
     private func cancel(key: ObjectIdentifier) {
         tasks[key]?.cancel()
         tasks[key] = nil
@@ -136,18 +197,18 @@ class PipelineImageLoader: HybridImageLoaderSpec {
         pendingLayouts[key] = nil
     }
 
-    private func load(into imageView: UIImageView, key: ObjectIdentifier) {
+    private func load(into imageView: UIImageView, key: ObjectIdentifier, generation: Int) {
         cancel(key: key)
 
         if let sizePx = explicitResize {
-            start(into: imageView, key: key, sizePx: sizePx)
+            start(into: imageView, key: key, generation: generation, sizePx: sizePx)
             return
         }
 
         let bounds = imageView.bounds.size
         if bounds.width > 0, bounds.height > 0 {
             let scale = Self.displayScale(of: imageView)
-            start(into: imageView, key: key, sizePx: CGSize(
+            start(into: imageView, key: key, generation: generation, sizePx: CGSize(
                 width: bounds.width * scale,
                 height: bounds.height * scale
             ))
@@ -160,14 +221,26 @@ class PipelineImageLoader: HybridImageLoaderSpec {
                 DispatchQueue.main.async {
                     guard let self, let imageView else { return }
                     guard self.pendingLayouts[key] != nil else { return }
-                    self.load(into: imageView, key: key)
+                    guard self.isCurrent(generation, for: key) else { return }
+                    self.load(into: imageView, key: key, generation: generation)
                 }
             }
         }
     }
 
-    private func start(into imageView: UIImageView, key: ObjectIdentifier, sizePx: CGSize) {
-        guard let imageUrl = URL(string: url) else { return }
+    private func start(
+        into imageView: UIImageView,
+        key: ObjectIdentifier,
+        generation: Int,
+        sizePx: CGSize
+    ) {
+        guard let imageUrl = HybridNitroImagePipeline.url(from: url) else {
+            // Android's loader hands a malformed URL to Coil, which reports it
+            // as a failed request; report it here too rather than returning
+            // silently and leaving `onError` waiting forever.
+            options?.onError?("Invalid URL: \(url)")
+            return
+        }
         let scale = Self.displayScale(of: imageView)
         let request = HybridNitroImagePipeline.makeRequest(
             url: imageUrl,
@@ -181,15 +254,32 @@ class PipelineImageLoader: HybridImageLoaderSpec {
         // bitmap is already in memory. The subscript honours the request's
         // `.disableMemoryCacheReads`, so `cache: 'disk'`/`'none'` still miss.
         if !request.options.contains(.disableMemoryCacheReads), let cached = pipeline.cache[request] {
-            imageView.image = cached.image
+            imageView.image = Self.displayImage(cached.image, scale: scale)
+            notifyLoad(cached.image)
             return
         }
         // Cancelling the Task cancels Nuke's request; a finished task stays in
         // the map (cancelling it is a no-op) until `cancel` replaces it.
-        tasks[key] = Task { @MainActor [weak imageView] in
-            guard let image = try? await pipeline.image(for: request) else { return }
-            guard !Task.isCancelled else { return }
-            imageView?.image = image
+        tasks[key] = Task { @MainActor [weak self, weak imageView] in
+            do {
+                let image = try await pipeline.image(for: request)
+                guard !Task.isCancelled else { return }
+                guard self?.isCurrent(generation, for: key) == true else { return }
+                imageView?.image = Self.displayImage(image, scale: scale)
+                self?.notifyLoad(image)
+            } catch {
+                // A load the view cancelled by detaching is not a failure.
+                guard !Task.isCancelled, !(error is CancellationError) else { return }
+                guard self?.isCurrent(generation, for: key) == true else { return }
+                self?.options?.onError?(error.localizedDescription)
+            }
         }
     }
+
+    /// Reports the displayed bitmap's size in pixels, when the caller asked
+    /// for it. `UIImage.size` is in points, so it needs the image's own scale.
+    private func notifyLoad(_ image: UIImage) {
+        guard let onLoad = options?.onLoad else { return }
+        onLoad(image.size.width * image.scale, image.size.height * image.scale)
+    }
 }

package/lib/commonjs/NativePipelineImage.js

@@ -7,6 +7,7 @@ exports.NativePipelineImage = void 0;
 var _react = require("react");
 var _reactNativeNitroImage = require("react-native-nitro-image");
 var _resizeForStyle = require("./resizeForStyle");
+var _resolveImageSource = require("./resolveImageSource");
 var _usePipelineImageLoader = require("./usePipelineImageLoader");
 var _jsxRuntime = require("react/jsx-runtime");
 /**
@@ -24,8 +25,9 @@ var _jsxRuntime = require("react/jsx-runtime");
  * the same pipeline and caches as `useImage`/`preLoadImage`.
  *
  * Compared to `PipelineImage`:
- * - No `onLoad`/`onError` callbacks — the loaded `Image` never crosses into
- *   JS. Use `PipelineImage` (or `useImage`) when you need them.
+ * - `onLoad` reports the bitmap's pixel size rather than the `Image` itself,
+ *   which never crosses into JS, and can fire more than once for a view. Use
+ *   `PipelineImage` (or `useImage`) when you need the `Image`.
  * - The bitmap is loaded once at the size the view first has; if the view is
  *   resized later, the bitmap scales with it instead of reloading.
  * @example
@@ -43,24 +45,38 @@ const NativePipelineImage = exports.NativePipelineImage = /*#__PURE__*/(0, _reac
   cornerRadius,
   cache,
   resize,
+  fit,
+  allowUpscale,
+  onLoad,
+  onError,
   style,
+  resizeMode,
   ...viewProps
 }, ref) {
   // Same precedence as PipelineImage: an explicit prop wins over style.
   const effectiveCornerRadius = cornerRadius ?? (0, _resizeForStyle.cornerRadiusForStyle)(style);
+  // Inline arrows are fine here — the hook keeps the callbacks in a ref, so a
+  // new identity doesn't recreate the loader (which would reload the image).
   const loader = (0, _usePipelineImageLoader.usePipelineImageLoader)(url, {
     blur,
     cornerRadius: effectiveCornerRadius,
     cache,
-    resize
+    resize,
+    // Same four values as the view's resizeMode; an explicit `fit` decouples
+    // them.
+    fit: fit ?? resizeMode,
+    allowUpscale,
+    onLoad,
+    onError
   });
   return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactNativeNitroImage.NativeNitroImage
   // Before the spread so a caller-provided recyclingKey wins.
   , {
-    recyclingKey: url,
+    recyclingKey: (0, _resolveImageSource.recyclingKeyFor)(url),
     ...viewProps,
     ref: ref,
     style: style,
+    resizeMode: resizeMode,
     image: loader
   });
 });

package/lib/commonjs/NativePipelineImage.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNativeNitroImage","_resizeForStyle","_usePipelineImageLoader","_jsxRuntime","NativePipelineImage","exports","forwardRef","url","blur","cornerRadius","cache","resize","style","viewProps","ref","effectiveCornerRadius","cornerRadiusForStyle","loader","usePipelineImageLoader","jsx","NativeNitroImage","recyclingKey","image","displayName"],"sourceRoot":"../../src","sources":["NativePipelineImage.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,sBAAA,GAAAD,OAAA;AAEA,IAAAE,eAAA,GAAAF,OAAA;AAMA,IAAAG,uBAAA,GAAAH,OAAA;AAAkE,IAAAI,WAAA,GAAAJ,OAAA;AAKlE;AACA;AACA;AACA;AACA;;AA+BA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMK,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,gBAAG,IAAAE,iBAAU,EAG3C,SAASF,mBAAmBA,CAC5B;EAAEG,GAAG;EAAEC,IAAI;EAAEC,YAAY;EAAEC,KAAK;EAAEC,MAAM;EAAEC,KAAK;EAAE,GAAGC;AAAU,CAAC,EAC/DC,GAAG,EACH;EACA;EACA,MAAMC,qBAAqB,GAAGN,YAAY,IAAI,IAAAO,oCAAoB,EAACJ,KAAK,CAAC;EACzE,MAAMK,MAAM,GAAG,IAAAC,8CAAsB,EAACX,GAAG,EAAE;IACzCC,IAAI;IACJC,YAAY,EAAEM,qBAAqB;IACnCL,KAAK;IACLC;EACF,CAAC,CAAC;EAEF,oBACE,IAAAR,WAAA,CAAAgB,GAAA,EAACnB,sBAAA,CAAAoB;EACC;EAAA;IACAC,YAAY,EAAEd,GAAI;IAAA,GACdM,SAAS;IACbC,GAAG,EAAEA,GAAI;IACTF,KAAK,EAAEA,KAAM;IACbU,KAAK,EAAEL;EAAO,CACf,CAAC;AAEN,CAAC,CAAC;;AAEF;AACA;AACAb,mBAAmB,CAACmB,WAAW,GAAG,qBAAqB","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNativeNitroImage","_resizeForStyle","_resolveImageSource","_usePipelineImageLoader","_jsxRuntime","NativePipelineImage","exports","forwardRef","url","blur","cornerRadius","cache","resize","fit","allowUpscale","onLoad","onError","style","resizeMode","viewProps","ref","effectiveCornerRadius","cornerRadiusForStyle","loader","usePipelineImageLoader","jsx","NativeNitroImage","recyclingKey","recyclingKeyFor","image","displayName"],"sourceRoot":"../../src","sources":["NativePipelineImage.tsx"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAEA,IAAAC,sBAAA,GAAAD,OAAA;AAEA,IAAAE,eAAA,GAAAF,OAAA;AACA,IAAAG,mBAAA,GAAAH,OAAA;AAOA,IAAAI,uBAAA,GAAAJ,OAAA;AAAkE,IAAAK,WAAA,GAAAL,OAAA;AAKlE;AACA;AACA;AACA;AACA;;AA2EA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMM,mBAAmB,GAAAC,OAAA,CAAAD,mBAAA,gBAAG,IAAAE,iBAAU,EAG3C,SAASF,mBAAmBA,CAC5B;EACEG,GAAG;EACHC,IAAI;EACJC,YAAY;EACZC,KAAK;EACLC,MAAM;EACNC,GAAG;EACHC,YAAY;EACZC,MAAM;EACNC,OAAO;EACPC,KAAK;EACLC,UAAU;EACV,GAAGC;AACL,CAAC,EACDC,GAAG,EACH;EACA;EACA,MAAMC,qBAAqB,GAAGX,YAAY,IAAI,IAAAY,oCAAoB,EAACL,KAAK,CAAC;EACzE;EACA;EACA,MAAMM,MAAM,GAAG,IAAAC,8CAAsB,EAAChB,GAAG,EAAE;IACzCC,IAAI;IACJC,YAAY,EAAEW,qBAAqB;IACnCV,KAAK;IACLC,MAAM;IACN;IACA;IACAC,GAAG,EAAEA,GAAG,IAAIK,UAAU;IACtBJ,YAAY;IACZC,MAAM;IACNC;EACF,CAAC,CAAC;EAEF,oBACE,IAAAZ,WAAA,CAAAqB,GAAA,EAACzB,sBAAA,CAAA0B;EACC;EAAA;IACAC,YAAY,EAAE,IAAAC,mCAAe,EAACpB,GAAG,CAAE;IAAA,GAC/BW,SAAS;IACbC,GAAG,EAAEA,GAAI;IACTH,KAAK,EAAEA,KAAM;IACbC,UAAU,EAAEA,UAAW;IACvBW,KAAK,EAAEN;EAAO,CACf,CAAC;AAEN,CAAC,CAAC;;AAEF;AACA;AACAlB,mBAAmB,CAACyB,WAAW,GAAG,qBAAqB","ignoreList":[]}

package/lib/commonjs/PipelineImage.js

@@ -61,10 +61,13 @@ const PipelineImage = exports.PipelineImage = /*#__PURE__*/(0, _react.forwardRef
   blur = 0,
   cornerRadius,
   cache,
+  fit,
+  allowUpscale,
   onLoad,
   onError,
   style,
   onLayout,
+  resizeMode,
   ...viewProps
 }, ref) {
   const scale = _reactNative.PixelRatio.get();
@@ -72,7 +75,15 @@ const PipelineImage = exports.PipelineImage = /*#__PURE__*/(0, _react.forwardRef
   const [layoutSize, setLayoutSize] = (0, _react.useState)(undefined);
   // A numeric style is what the caller declared, so it wins and starts the
   // request a frame earlier; the measured layout is the fallback.
-  const resize = styleSize ?? layoutSize;
+  const size = styleSize ?? layoutSize;
+  // The view's resizeMode and the bitmap's fit are the same four values;
+  // an explicit `fit` decouples them.
+  const effectiveFit = fit ?? resizeMode;
+  const resize = size ? {
+    ...size,
+    fit: effectiveFit,
+    allowUpscale
+  } : undefined;
   // Same precedence: an explicit prop wins over what style implies.
   const effectiveCornerRadius = cornerRadius ?? (0, _resizeForStyle.cornerRadiusForStyle)(style) ?? 0;
   const {
@@ -115,6 +126,7 @@ const PipelineImage = exports.PipelineImage = /*#__PURE__*/(0, _react.forwardRef
     ...viewProps,
     ref: ref,
     style: style,
+    resizeMode: resizeMode,
     onLayout: handleLayout,
     image: image
   });

package/lib/commonjs/PipelineImage.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_reactNative","_reactNativeNitroImage","_resizeForStyle","_useImage","_jsxRuntime","sameSize","a","b","width","height","scaleRadius","cornerRadius","scale","topLeft","topRight","bottomLeft","bottomRight","PipelineImage","exports","forwardRef","url","blur","cache","onLoad","onError","style","onLayout","viewProps","ref","PixelRatio","get","styleSize","resizeForStyle","layoutSize","setLayoutSize","useState","undefined","resize","effectiveCornerRadius","cornerRadiusForStyle","image","error","useImage","enabled","onLoadRef","useRef","onErrorRef","useEffect","current","handleLayout","event","nativeEvent","layout","next","resizeForLayout","prev","jsx","NativeNitroImage","displayName"],"sourceRoot":"../../src","sources":["PipelineImage.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_react","require","_reactNative","_reactNativeNitroImage","_resizeForStyle","_useImage","_jsxRuntime","sameSize","a","b","width","height","scaleRadius","cornerRadius","scale","topLeft","topRight","bottomLeft","bottomRight","PipelineImage","exports","forwardRef","url","blur","cache","fit","allowUpscale","onLoad","onError","style","onLayout","resizeMode","viewProps","ref","PixelRatio","get","styleSize","resizeForStyle","layoutSize","setLayoutSize","useState","undefined","size","effectiveFit","resize","effectiveCornerRadius","cornerRadiusForStyle","image","error","useImage","enabled","onLoadRef","useRef","onErrorRef","useEffect","current","handleLayout","event","nativeEvent","layout","next","resizeForLayout","prev","jsx","NativeNitroImage","displayName"],"sourceRoot":"../../src","sources":["PipelineImage.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "PipelineImage", {
     return _PipelineImage.PipelineImage;
   }
 });
+Object.defineProperty(exports, "UNREGISTERED_ASSET_URL", {
+  enumerable: true,
+  get: function () {
+    return _resolveImageSource.UNREGISTERED_ASSET_URL;
+  }
+});
 Object.defineProperty(exports, "cornerRadiusForStyle", {
   enumerable: true,
   get: function () {
@@ -39,6 +45,12 @@ Object.defineProperty(exports, "resizeForStyle", {
     return _resizeForStyle.resizeForStyle;
   }
 });
+Object.defineProperty(exports, "resolveImageUrl", {
+  enumerable: true,
+  get: function () {
+    return _resolveImageSource.resolveImageUrl;
+  }
+});
 Object.defineProperty(exports, "useImage", {
   enumerable: true,
   get: function () {
@@ -54,6 +66,7 @@ Object.defineProperty(exports, "usePipelineImageLoader", {
 var _NativePipelineImage = require("./NativePipelineImage");
 var _NitroImagePipeline = require("./NitroImagePipeline");
 var _PipelineImage = require("./PipelineImage");
+var _resolveImageSource = require("./resolveImageSource");
 var _resizeForStyle = require("./resizeForStyle");
 var _useImage = require("./useImage");
 var _usePipelineImageLoader = require("./usePipelineImageLoader");

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_NativePipelineImage","require","_NitroImagePipeline","_PipelineImage","_resizeForStyle","_useImage","_usePipelineImageLoader"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,oBAAA,GAAAC,OAAA;AAKA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AAKA,IAAAG,eAAA,GAAAH,OAAA;AAYA,IAAAI,SAAA,GAAAJ,OAAA;AACA,IAAAK,uBAAA,GAAAL,OAAA","ignoreList":[]}
+{"version":3,"names":["_NativePipelineImage","require","_NitroImagePipeline","_PipelineImage","_resolveImageSource","_resizeForStyle","_useImage","_usePipelineImageLoader"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,oBAAA,GAAAC,OAAA;AAKA,IAAAC,mBAAA,GAAAD,OAAA;AACA,IAAAE,cAAA,GAAAF,OAAA;AAKA,IAAAG,mBAAA,GAAAH,OAAA;AAKA,IAAAI,eAAA,GAAAJ,OAAA;AAaA,IAAAK,SAAA,GAAAL,OAAA;AACA,IAAAM,uBAAA,GAAAN,OAAA","ignoreList":[]}

package/lib/commonjs/resizeForStyle.js

@@ -10,7 +10,9 @@ var _reactNative = require("react-native");
 /**
  * Converts a layout size in points (dp) to the pipeline's `resize` option in
  * whole bitmap pixels using `PixelRatio.getPixelSizeForLayoutSize`. Returns
- * `undefined` unless both values are positive numbers.
+ * `undefined` unless both values are positive numbers. Spread a `fit` into
+ * the result for the other resize modes — under `contain` and `center` the
+ * size is the box the bitmap fits in, not necessarily its final size.
  */
 function resizeForLayout(width, height) {
   if (typeof width !== 'number' || typeof height !== 'number') {

package/lib/commonjs/resizeForStyle.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","resizeForLayout","width","height","undefined","pixelWidth","PixelRatio","getPixelSizeForLayoutSize","pixelHeight","resizeForStyle","style","flat","StyleSheet","flatten","cornerRadiusForStyle","base","borderRadius","topLeft","borderTopLeftRadius","topRight","borderTopRightRadius","bottomLeft","borderBottomLeftRadius","bottomRight","borderBottomRightRadius"],"sourceRoot":"../../src","sources":["resizeForStyle.ts"],"mappings":";;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAYA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAC7BC,KAAc,EACdC,MAAe,EACY;EAC3B,IAAI,OAAOD,KAAK,KAAK,QAAQ,IAAI,OAAOC,MAAM,KAAK,QAAQ,EAAE;IAC3D,OAAOC,SAAS;EAClB;EACA,MAAMC,UAAU,GAAGC,uBAAU,CAACC,yBAAyB,CAACL,KAAK,CAAC;EAC9D,MAAMM,WAAW,GAAGF,uBAAU,CAACC,yBAAyB,CAACJ,MAAM,CAAC;EAChE,OAAOE,UAAU,GAAG,CAAC,IAAIG,WAAW,GAAG,CAAC,GACpC;IAAEN,KAAK,EAAEG,UAAU;IAAEF,MAAM,EAAEK;EAAY,CAAC,GAC1CJ,SAAS;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,cAAcA,CAC5BC,KAA2B,EACA;EAC3B,MAAMC,IAAI,GAAGC,uBAAU,CAACC,OAAO,CAACH,KAAK,CAAC;EACtC,OAAOT,eAAe,CAACU,IAAI,EAAET,KAAK,EAAES,IAAI,EAAER,MAAM,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASW,oBAAoBA,CAClCJ,KAA2B,EACO;EAClC,MAAMC,IAAI,GAAGC,uBAAU,CAACC,OAAO,CAACH,KAAK,CAAC;EACtC,MAAMK,IAAI,GACR,OAAOJ,IAAI,EAAEK,YAAY,KAAK,QAAQ,GAAGL,IAAI,CAACK,YAAY,GAAGZ,SAAS;EACxE,MAAMa,OAAO,GACX,OAAON,IAAI,EAAEO,mBAAmB,KAAK,QAAQ,GACzCP,IAAI,CAACO,mBAAmB,GACxBd,SAAS;EACf,MAAMe,QAAQ,GACZ,OAAOR,IAAI,EAAES,oBAAoB,KAAK,QAAQ,GAC1CT,IAAI,CAACS,oBAAoB,GACzBhB,SAAS;EACf,MAAMiB,UAAU,GACd,OAAOV,IAAI,EAAEW,sBAAsB,KAAK,QAAQ,GAC5CX,IAAI,CAACW,sBAAsB,GAC3BlB,SAAS;EACf,MAAMmB,WAAW,GACf,OAAOZ,IAAI,EAAEa,uBAAuB,KAAK,QAAQ,GAC7Cb,IAAI,CAACa,uBAAuB,GAC5BpB,SAAS;EAEf,IACEa,OAAO,KAAKb,SAAS,IACrBe,QAAQ,KAAKf,SAAS,IACtBiB,UAAU,KAAKjB,SAAS,IACxBmB,WAAW,KAAKnB,SAAS,EACzB;IACA,OAAOW,IAAI;EACb;EAEA,OAAO;IACLE,OAAO,EAAEA,OAAO,IAAIF,IAAI;IACxBI,QAAQ,EAAEA,QAAQ,IAAIJ,IAAI;IAC1BM,UAAU,EAAEA,UAAU,IAAIN,IAAI;IAC9BQ,WAAW,EAAEA,WAAW,IAAIR;EAC9B,CAAC;AACH","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","resizeForLayout","width","height","undefined","pixelWidth","PixelRatio","getPixelSizeForLayoutSize","pixelHeight","resizeForStyle","style","flat","StyleSheet","flatten","cornerRadiusForStyle","base","borderRadius","topLeft","borderTopLeftRadius","topRight","borderTopRightRadius","bottomLeft","borderBottomLeftRadius","bottomRight","borderBottomRightRadius"],"sourceRoot":"../../src","sources":["resizeForStyle.ts"],"mappings":";;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAYA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAC7BC,KAAc,EACdC,MAAe,EACY;EAC3B,IAAI,OAAOD,KAAK,KAAK,QAAQ,IAAI,OAAOC,MAAM,KAAK,QAAQ,EAAE;IAC3D,OAAOC,SAAS;EAClB;EACA,MAAMC,UAAU,GAAGC,uBAAU,CAACC,yBAAyB,CAACL,KAAK,CAAC;EAC9D,MAAMM,WAAW,GAAGF,uBAAU,CAACC,yBAAyB,CAACJ,MAAM,CAAC;EAChE,OAAOE,UAAU,GAAG,CAAC,IAAIG,WAAW,GAAG,CAAC,GACpC;IAAEN,KAAK,EAAEG,UAAU;IAAEF,MAAM,EAAEK;EAAY,CAAC,GAC1CJ,SAAS;AACf;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASK,cAAcA,CAC5BC,KAA2B,EACA;EAC3B,MAAMC,IAAI,GAAGC,uBAAU,CAACC,OAAO,CAACH,KAAK,CAAC;EACtC,OAAOT,eAAe,CAACU,IAAI,EAAET,KAAK,EAAES,IAAI,EAAER,MAAM,CAAC;AACnD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASW,oBAAoBA,CAClCJ,KAA2B,EACO;EAClC,MAAMC,IAAI,GAAGC,uBAAU,CAACC,OAAO,CAACH,KAAK,CAAC;EACtC,MAAMK,IAAI,GACR,OAAOJ,IAAI,EAAEK,YAAY,KAAK,QAAQ,GAAGL,IAAI,CAACK,YAAY,GAAGZ,SAAS;EACxE,MAAMa,OAAO,GACX,OAAON,IAAI,EAAEO,mBAAmB,KAAK,QAAQ,GACzCP,IAAI,CAACO,mBAAmB,GACxBd,SAAS;EACf,MAAMe,QAAQ,GACZ,OAAOR,IAAI,EAAES,oBAAoB,KAAK,QAAQ,GAC1CT,IAAI,CAACS,oBAAoB,GACzBhB,SAAS;EACf,MAAMiB,UAAU,GACd,OAAOV,IAAI,EAAEW,sBAAsB,KAAK,QAAQ,GAC5CX,IAAI,CAACW,sBAAsB,GAC3BlB,SAAS;EACf,MAAMmB,WAAW,GACf,OAAOZ,IAAI,EAAEa,uBAAuB,KAAK,QAAQ,GAC7Cb,IAAI,CAACa,uBAAuB,GAC5BpB,SAAS;EAEf,IACEa,OAAO,KAAKb,SAAS,IACrBe,QAAQ,KAAKf,SAAS,IACtBiB,UAAU,KAAKjB,SAAS,IACxBmB,WAAW,KAAKnB,SAAS,EACzB;IACA,OAAOW,IAAI;EACb;EAEA,OAAO;IACLE,OAAO,EAAEA,OAAO,IAAIF,IAAI;IACxBI,QAAQ,EAAEA,QAAQ,IAAIJ,IAAI;IAC1BM,UAAU,EAAEA,UAAU,IAAIN,IAAI;IAC9BQ,WAAW,EAAEA,WAAW,IAAIR;EAC9B,CAAC;AACH","ignoreList":[]}

package/lib/commonjs/resolveImageSource.js

@@ -0,0 +1,89 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.UNREGISTERED_ASSET_URL = void 0;
+exports.recyclingKeyFor = recyclingKeyFor;
+exports.resolveImageUrl = resolveImageUrl;
+exports.resolveImageUrlOrFallback = resolveImageUrlOrFallback;
+var _reactNative = require("react-native");
+/**
+ * What the pipeline can load: a URL string, or the id a `require()`d image
+ * asset evaluates to.
+ *
+ * As a string, `url` is passed to the native loader as-is. Accepted forms:
+ *
+ * - `https://` / `http://` — fetched over the network and cached on disk.
+ * - `file://` URLs and plain absolute paths (`/var/…/photo.jpg`) — read from
+ *   the file system. The result is cached in memory only; there is nothing
+ *   to gain from copying a local file into the disk cache.
+ * - Android also accepts `content://` URIs and, from a release build's
+ *   resources, a bare drawable name — which is what `require()` resolves to
+ *   there. iOS resolves `require()` to a `file://` URL into the app bundle.
+ *
+ * A `require('./photo.png')` is resolved with `Image.resolveAssetSource`, so
+ * it works the same in debug (streamed from Metro) and release (bundled).
+ */
+
+/**
+ * Turns an {@linkcode ImageSource} into the URL string the native pipeline
+ * loads: strings pass through unchanged, a `require()`d asset is resolved via
+ * `Image.resolveAssetSource` (the scale-matched variant, like `<Image>`).
+ *
+ * The components and hooks call this for you; use it when calling
+ * `NitroImagePipeline.loadImage`/`preLoadImage` directly with a `require()`.
+ * @throws If `source` is a number that is not a registered asset.
+ * @example
+ * ```ts
+ * const image = await NitroImagePipeline.loadImage(
+ *   resolveImageUrl(require('./photo.png')),
+ *   { blur: 4 },
+ * );
+ * ```
+ */
+function resolveImageUrl(source) {
+  if (typeof source === 'string') {
+    return source;
+  }
+  const resolved = _reactNative.Image.resolveAssetSource(source);
+  if (resolved == null) {
+    throw new Error(`Not a registered image asset: require() id ${source}`);
+  }
+  return resolved.uri;
+}
+
+/**
+ * A URL no loader can resolve, standing in for a `require()` id that is not
+ * a registered asset. Its scheme has no fetcher on either platform, so the
+ * request fails at load time — the same way a missing file does — instead of
+ * throwing from a component's render.
+ */
+const UNREGISTERED_ASSET_URL = exports.UNREGISTERED_ASSET_URL = 'unregistered-asset://';
+
+/**
+ * {@linkcode resolveImageUrl} for code that runs during render: an
+ * unregistered `require()` id yields {@linkcode UNREGISTERED_ASSET_URL} (and
+ * a warning in development) rather than throwing.
+ */
+function resolveImageUrlOrFallback(source) {
+  try {
+    return resolveImageUrl(source);
+  } catch (error) {
+    if (__DEV__) {
+      console.warn(`[react-native-nitro-image-pipeline] ${error.message}`);
+    }
+    return UNREGISTERED_ASSET_URL;
+  }
+}
+
+/**
+ * A stable, per-source `recyclingKey` for `<NativeNitroImage>`: the URL
+ * itself for strings, and a tag derived from the asset id for a `require()`
+ * (resolving it would cost an asset-registry lookup per render for nothing
+ * more than a distinct key).
+ */
+function recyclingKeyFor(source) {
+  return typeof source === 'string' ? source : `asset:${source}`;
+}
+//# sourceMappingURL=resolveImageSource.js.map

package/lib/commonjs/resolveImageSource.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["_reactNative","require","resolveImageUrl","source","resolved","RNImage","resolveAssetSource","Error","uri","UNREGISTERED_ASSET_URL","exports","resolveImageUrlOrFallback","error","__DEV__","console","warn","message","recyclingKeyFor"],"sourceRoot":"../../src","sources":["resolveImageSource.ts"],"mappings":";;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASC,eAAeA,CAACC,MAAmB,EAAU;EAC3D,IAAI,OAAOA,MAAM,KAAK,QAAQ,EAAE;IAC9B,OAAOA,MAAM;EACf;EACA,MAAMC,QAAQ,GAAGC,kBAAO,CAACC,kBAAkB,CAACH,MAAM,CAAC;EACnD,IAAIC,QAAQ,IAAI,IAAI,EAAE;IACpB,MAAM,IAAIG,KAAK,CAAC,8CAA8CJ,MAAM,EAAE,CAAC;EACzE;EACA,OAAOC,QAAQ,CAACI,GAAG;AACrB;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,MAAMC,sBAAsB,GAAAC,OAAA,CAAAD,sBAAA,GAAG,uBAAuB;;AAE7D;AACA;AACA;AACA;AACA;AACO,SAASE,yBAAyBA,CAACR,MAAmB,EAAU;EACrE,IAAI;IACF,OAAOD,eAAe,CAACC,MAAM,CAAC;EAChC,CAAC,CAAC,OAAOS,KAAK,EAAE;IACd,IAAIC,OAAO,EAAE;MACXC,OAAO,CAACC,IAAI,CACV,uCAAwCH,KAAK,CAAWI,OAAO,EACjE,CAAC;IACH;IACA,OAAOP,sBAAsB;EAC/B;AACF;;AAEA;AACA;AACA;AACA;AACA;AACA;AACO,SAASQ,eAAeA,CAACd,MAAmB,EAAU;EAC3D,OAAO,OAAOA,MAAM,KAAK,QAAQ,GAAGA,MAAM,GAAG,SAASA,MAAM,EAAE;AAChE","ignoreList":[]}

package/lib/commonjs/useImage.js

@@ -6,12 +6,14 @@ Object.defineProperty(exports, "__esModule", {
 exports.useImage = useImage;
 var _react = require("react");
 var _NitroImagePipeline = require("./NitroImagePipeline");
+var _resolveImageSource = require("./resolveImageSource");
 /**
- * A hook to asynchronously load an image from the
- * given {@linkcode AsyncImageSource} into memory.
+ * A hook to asynchronously load an image from `url` through the pipeline
+ * into memory.
  * @example
  * ```ts
- * const { image, error } = useImage({ filePath: '/tmp/image.jpg' })
+ * const { image, error } = useImage({ url: 'https://example.com/photo.jpg' });
+ * const { image: logo } = useImage({ url: require('./logo.png') });
  * ```
  */
 function useImage({
@@ -40,6 +42,8 @@ function useImage({
   } = isUniformRadius ? {} : cornerRadius;
   const resizeWidth = resize?.width ?? 0;
   const resizeHeight = resize?.height ?? 0;
+  const resizeFit = resize?.fit;
+  const resizeAllowUpscale = resize?.allowUpscale;
   (0, _react.useEffect)(() => {
     let cancelled = false;
     // Only reset to the loading state when the URL changes; for same-URL
@@ -55,7 +59,9 @@ function useImage({
     if (enabled) {
       (async () => {
         try {
-          const result = await _NitroImagePipeline.NitroImagePipeline.loadImage(url, {
+          // Resolved inside the try so an unregistered `require()` id
+          // surfaces as the error state instead of throwing from the effect.
+          const result = await _NitroImagePipeline.NitroImagePipeline.loadImage((0, _resolveImageSource.resolveImageUrl)(url), {
             blur,
             cornerRadius: isUniformRadius ? uniformRadius : {
               topLeft,
@@ -65,7 +71,9 @@ function useImage({
             },
             resize: resizeWidth > 0 && resizeHeight > 0 ? {
               width: resizeWidth,
-              height: resizeHeight
+              height: resizeHeight,
+              fit: resizeFit,
+              allowUpscale: resizeAllowUpscale
             } : undefined,
             cache
           });
@@ -89,7 +97,7 @@ function useImage({
     return () => {
       cancelled = true;
     };
-  }, [url, blur, isUniformRadius, uniformRadius, topLeft, topRight, bottomLeft, bottomRight, resizeWidth, resizeHeight, cache, enabled]);
+  }, [url, blur, isUniformRadius, uniformRadius, topLeft, topRight, bottomLeft, bottomRight, resizeWidth, resizeHeight, resizeFit, resizeAllowUpscale, cache, enabled]);
   return image;
 }
 //# sourceMappingURL=useImage.js.map

package/lib/commonjs/useImage.js.map

@@ -1 +1 @@
-{"version":3,"names":["_react","require","_NitroImagePipeline","useImage","url","blur","cornerRadius","resize","cache","enabled","image","setImage","useState","undefined","error","loadedUrlRef","useRef","isUniformRadius","uniformRadius","topLeft","topRight","bottomLeft","bottomRight","resizeWidth","width","resizeHeight","height","useEffect","cancelled","current","result","NitroImagePipeline","loadImage","e","Error"],"sourceRoot":"../../src","sources":["useImage.ts"],"mappings":";;;;;;AAAA,IAAAA,MAAA,GAAAC,OAAA;AAGA,IAAAC,mBAAA,GAAAD,OAAA;AAwBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAASE,QAAQA,CAAC;EACvBC,GAAG;EACHC,IAAI,GAAG,CAAC;EACRC,YAAY,GAAG,CAAC;EAChBC,MAAM;EACNC,KAAK;EACLC,OAAO,GAAG;AA+BZ,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,EAACZ,GAAG,CAAC;;EAEhC;EACA;EACA,MAAMa,eAAe,GAAG,OAAOX,YAAY,KAAK,QAAQ;EACxD,MAAMY,aAAa,GAAGD,eAAe,GAAGX,YAAY,GAAG,CAAC;EACxD,MAAM;IACJa,OAAO,GAAG,CAAC;IACXC,QAAQ,GAAG,CAAC;IACZC,UAAU,GAAG,CAAC;IACdC,WAAW,GAAG;EAChB,CAAC,GAAGL,eAAe,GAAG,CAAC,CAAC,GAAGX,YAAY;EACvC,MAAMiB,WAAW,GAAGhB,MAAM,EAAEiB,KAAK,IAAI,CAAC;EACtC,MAAMC,YAAY,GAAGlB,MAAM,EAAEmB,MAAM,IAAI,CAAC;EAExC,IAAAC,gBAAS,EAAC,MAAM;IACd,IAAIC,SAAS,GAAG,KAAK;IACrB;IACA;IACA;IACA,IAAIb,YAAY,CAACc,OAAO,KAAKzB,GAAG,EAAE;MAChCW,YAAY,CAACc,OAAO,GAAGzB,GAAG;MAC1BO,QAAQ,CAAC;QAAED,KAAK,EAAEG,SAAS;QAAEC,KAAK,EAAED;MAAU,CAAC,CAAC;IAClD;IAEA,IAAIJ,OAAO,EAAE;MACX,CAAC,YAAY;QACX,IAAI;UACF,MAAMqB,MAAM,GAAG,MAAMC,sCAAkB,CAACC,SAAS,CAAC5B,GAAG,EAAE;YACrDC,IAAI;YACJC,YAAY,EAAEW,eAAe,GACzBC,aAAa,GACb;cAAEC,OAAO;cAAEC,QAAQ;cAAEC,UAAU;cAAEC;YAAY,CAAC;YAClDf,MAAM,EACJgB,WAAW,GAAG,CAAC,IAAIE,YAAY,GAAG,CAAC,GAC/B;cAAED,KAAK,EAAED,WAAW;cAAEG,MAAM,EAAED;YAAa,CAAC,GAC5CZ,SAAS;YACfL;UACF,CAAC,CAAC;UAEF,IAAI,CAACoB,SAAS,EAAE;YACdjB,QAAQ,CAAC;cAAED,KAAK,EAAEoB,MAAM;cAAEhB,KAAK,EAAED;YAAU,CAAC,CAAC;UAC/C;QACF,CAAC,CAAC,OAAOoB,CAAC,EAAE;UACV,MAAMnB,KAAK,GAAGmB,CAAC,YAAYC,KAAK,GAAGD,CAAC,GAAG,IAAIC,KAAK,CAAC,GAAGD,CAAC,EAAE,CAAC;UACxD,IAAI,CAACL,SAAS,EAAE;YACdjB,QAAQ,CAAC;cAAED,KAAK,EAAEG,SAAS;cAAEC,KAAK,EAAEA;YAAM,CAAC,CAAC;UAC9C;QACF;MACF,CAAC,EAAE,CAAC;IACN;IAEA,OAAO,MAAM;MACXc,SAAS,GAAG,IAAI;IAClB,CAAC;EACH,CAAC,EAAE,CACDxB,GAAG,EACHC,IAAI,EACJY,eAAe,EACfC,aAAa,EACbC,OAAO,EACPC,QAAQ,EACRC,UAAU,EACVC,WAAW,EACXC,WAAW,EACXE,YAAY,EACZjB,KAAK,EACLC,OAAO,CACR,CAAC;EAEF,OAAOC,KAAK;AACd","ignoreList":[]}
+{"version":3,"names":["_react","require","_NitroImagePipeline","_resolveImageSource","useImage","url","blur","cornerRadius","resize","cache","enabled","image","setImage","useState","undefined","error","loadedUrlRef","useRef","isUniformRadius","uniformRadius","topLeft","topRight","bottomLeft","bottomRight","resizeWidth","width","resizeHeight","height","resizeFit","fit","resizeAllowUpscale","allowUpscale","useEffect","cancelled","current","result","NitroImagePipeline","loadImage","resolveImageUrl","e","Error"],"sourceRoot":"../../src","sources":["useImage.ts"],"mappings":"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","ignoreList":[]}