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

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

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

package/nitrogen/generated/ios/swift/CornerRadii.swift

@@ -0,0 +1,96 @@
+///
+/// CornerRadii.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 `CornerRadii`, backed by a C++ struct.
+ */
+public typealias CornerRadii = margelo.nitro.nitroimagepipeline.CornerRadii
+
+public extension CornerRadii {
+  private typealias bridge = margelo.nitro.nitroimagepipeline.bridge.swift
+
+  /**
+   * Create a new instance of `CornerRadii`.
+   */
+  init(topLeft: Double?, topRight: Double?, bottomLeft: Double?, bottomRight: Double?) {
+    self.init({ () -> bridge.std__optional_double_ in
+      if let __unwrappedValue = topLeft {
+        return bridge.create_std__optional_double_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_double_ in
+      if let __unwrappedValue = topRight {
+        return bridge.create_std__optional_double_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_double_ in
+      if let __unwrappedValue = bottomLeft {
+        return bridge.create_std__optional_double_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }(), { () -> bridge.std__optional_double_ in
+      if let __unwrappedValue = bottomRight {
+        return bridge.create_std__optional_double_(__unwrappedValue)
+      } else {
+        return .init()
+      }
+    }())
+  }
+
+  @inline(__always)
+  var topLeft: Double? {
+    return { () -> Double? in
+      if bridge.has_value_std__optional_double_(self.__topLeft) {
+        let __unwrapped = bridge.get_std__optional_double_(self.__topLeft)
+        return __unwrapped
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var topRight: Double? {
+    return { () -> Double? in
+      if bridge.has_value_std__optional_double_(self.__topRight) {
+        let __unwrapped = bridge.get_std__optional_double_(self.__topRight)
+        return __unwrapped
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var bottomLeft: Double? {
+    return { () -> Double? in
+      if bridge.has_value_std__optional_double_(self.__bottomLeft) {
+        let __unwrapped = bridge.get_std__optional_double_(self.__bottomLeft)
+        return __unwrapped
+      } else {
+        return nil
+      }
+    }()
+  }
+  
+  @inline(__always)
+  var bottomRight: Double? {
+    return { () -> Double? in
+      if bridge.has_value_std__optional_double_(self.__bottomRight) {
+        let __unwrapped = bridge.get_std__optional_double_(self.__bottomRight)
+        return __unwrapped
+      } else {
+        return nil
+      }
+    }()
+  }
+}

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: Double?) {
+  init(blur: Double?, cache: CacheOption?, cornerRadius: Variant_Double_CornerRadii?) {
     self.init({ () -> bridge.std__optional_double_ in
       if let __unwrappedValue = blur {
         return bridge.create_std__optional_double_(__unwrappedValue)
@@ -31,9 +31,16 @@ public extension Options {
       } else {
         return .init()
       }
-    }(), { () -> bridge.std__optional_double_ in
+    }(), { () -> bridge.std__optional_std__variant_double__CornerRadii__ in
       if let __unwrappedValue = cornerRadius {
-        return bridge.create_std__optional_double_(__unwrappedValue)
+        return bridge.create_std__optional_std__variant_double__CornerRadii__({ () -> bridge.std__variant_double__CornerRadii_ in
+          switch __unwrappedValue {
+            case .first(let __value):
+              return bridge.create_std__variant_double__CornerRadii_(__value)
+            case .second(let __value):
+              return bridge.create_std__variant_double__CornerRadii_(__value)
+          }
+        }().variant)
       } else {
         return .init()
       }
@@ -58,11 +65,23 @@ public extension Options {
   }
   
   @inline(__always)
-  var cornerRadius: Double? {
-    return { () -> Double? in
-      if bridge.has_value_std__optional_double_(self.__cornerRadius) {
-        let __unwrapped = bridge.get_std__optional_double_(self.__cornerRadius)
-        return __unwrapped
+  var cornerRadius: Variant_Double_CornerRadii? {
+    return { () -> Variant_Double_CornerRadii? in
+      if bridge.has_value_std__optional_std__variant_double__CornerRadii__(self.__cornerRadius) {
+        let __unwrapped = bridge.get_std__optional_std__variant_double__CornerRadii__(self.__cornerRadius)
+        return { () -> Variant_Double_CornerRadii in
+          let __variant = bridge.std__variant_double__CornerRadii_(__unwrapped)
+          switch __variant.index() {
+            case 0:
+              let __actual = __variant.get_0()
+              return .first(__actual)
+            case 1:
+              let __actual = __variant.get_1()
+              return .second(__actual)
+            default:
+              fatalError("Variant can never have index \(__variant.index())!")
+          }
+        }()
       } else {
         return nil
       }

package/nitrogen/generated/ios/swift/Variant_Double_CornerRadii.swift

@@ -0,0 +1,30 @@
+///
+/// Variant_Double_CornerRadii.swift
+/// This file was generated by nitrogen. DO NOT MODIFY THIS FILE.
+/// https://github.com/mrousavy/nitro
+/// Copyright © Marc Rousavy @ Margelo
+///
+
+
+
+/**
+ * An Swift enum with associated values representing a Variant/Union type.
+ * JS type: `number | struct`
+ */
+@frozen
+public indirect enum Variant_Double_CornerRadii {
+  case first(Double)
+  case second(CornerRadii)
+}
+
+public extension Variant_Double_CornerRadii {
+  func asType<T>(_ type: T.Type = T.self) -> T? {
+    switch self {
+      case .first(let value): return value as? T
+      case .second(let value): return value as? T
+    }
+  }
+  func isType<T>(_ type: T.Type = T.self) -> Bool {
+    return self.asType(type) != nil
+  }
+}

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

@@ -0,0 +1,95 @@
+///
+/// CornerRadii.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
+
+
+
+#include <optional>
+
+namespace margelo::nitro::nitroimagepipeline {
+
+  /**
+   * A struct which can be represented as a JavaScript object (CornerRadii).
+   */
+  struct CornerRadii final {
+  public:
+    std::optional<double> topLeft     SWIFT_PRIVATE;
+    std::optional<double> topRight     SWIFT_PRIVATE;
+    std::optional<double> bottomLeft     SWIFT_PRIVATE;
+    std::optional<double> bottomRight     SWIFT_PRIVATE;
+
+  public:
+    CornerRadii() = default;
+    explicit CornerRadii(std::optional<double> topLeft, std::optional<double> topRight, std::optional<double> bottomLeft, std::optional<double> bottomRight): topLeft(topLeft), topRight(topRight), bottomLeft(bottomLeft), bottomRight(bottomRight) {}
+
+  public:
+    friend bool operator==(const CornerRadii& lhs, const CornerRadii& rhs) = default;
+  };
+
+} // namespace margelo::nitro::nitroimagepipeline
+
+namespace margelo::nitro {
+
+  // C++ CornerRadii <> JS CornerRadii (object)
+  template <>
+  struct JSIConverter<margelo::nitro::nitroimagepipeline::CornerRadii> final {
+    static inline margelo::nitro::nitroimagepipeline::CornerRadii fromJSI(jsi::Runtime& runtime, const jsi::Value& arg) {
+      jsi::Object obj = arg.asObject(runtime);
+      return margelo::nitro::nitroimagepipeline::CornerRadii(
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "topLeft"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "topRight"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bottomLeft"))),
+        JSIConverter<std::optional<double>>::fromJSI(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bottomRight")))
+      );
+    }
+    static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroimagepipeline::CornerRadii& arg) {
+      jsi::Object obj(runtime);
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "topLeft"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.topLeft));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "topRight"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.topRight));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "bottomLeft"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.bottomLeft));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "bottomRight"), JSIConverter<std::optional<double>>::toJSI(runtime, arg.bottomRight));
+      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<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "topLeft")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "topRight")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bottomLeft")))) return false;
+      if (!JSIConverter<std::optional<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "bottomRight")))) return false;
+      return true;
+    }
+  };
+
+} // namespace margelo::nitro

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

@@ -30,9 +30,13 @@
 
 // Forward declaration of `CacheOption` to properly resolve imports.
 namespace margelo::nitro::nitroimagepipeline { enum class CacheOption; }
+// Forward declaration of `CornerRadii` to properly resolve imports.
+namespace margelo::nitro::nitroimagepipeline { struct CornerRadii; }
 
 #include <optional>
 #include "CacheOption.hpp"
+#include "CornerRadii.hpp"
+#include <variant>
 
 namespace margelo::nitro::nitroimagepipeline {
 
@@ -43,11 +47,11 @@ namespace margelo::nitro::nitroimagepipeline {
   public:
     std::optional<double> blur     SWIFT_PRIVATE;
     std::optional<CacheOption> cache     SWIFT_PRIVATE;
-    std::optional<double> cornerRadius     SWIFT_PRIVATE;
+    std::optional<std::variant<double, CornerRadii>> cornerRadius     SWIFT_PRIVATE;
 
   public:
     Options() = default;
-    explicit Options(std::optional<double> blur, std::optional<CacheOption> cache, std::optional<double> cornerRadius): blur(blur), cache(cache), cornerRadius(cornerRadius) {}
+    explicit Options(std::optional<double> blur, std::optional<CacheOption> cache, std::optional<std::variant<double, CornerRadii>> cornerRadius): blur(blur), cache(cache), cornerRadius(cornerRadius) {}
 
   public:
     friend bool operator==(const Options& lhs, const Options& rhs) = default;
@@ -65,14 +69,14 @@ 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<double>>::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")))
       );
     }
     static inline jsi::Value toJSI(jsi::Runtime& runtime, const margelo::nitro::nitroimagepipeline::Options& arg) {
       jsi::Object obj(runtime);
       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<double>>::toJSI(runtime, arg.cornerRadius));
+      obj.setProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius"), JSIConverter<std::optional<std::variant<double, margelo::nitro::nitroimagepipeline::CornerRadii>>>::toJSI(runtime, arg.cornerRadius));
       return obj;
     }
     static inline bool canConvert(jsi::Runtime& runtime, const jsi::Value& value) {
@@ -85,7 +89,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<double>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius")))) return false;
+      if (!JSIConverter<std::optional<std::variant<double, margelo::nitro::nitroimagepipeline::CornerRadii>>>::canConvert(runtime, obj.getProperty(runtime, PropNameIDCache::get(runtime, "cornerRadius")))) return false;
       return true;
     }
   };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "react-native-nitro-image-pipeline",
-  "version": "0.3.5",
+  "version": "1.1.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",
@@ -9,12 +9,15 @@
   "source": "src/index",
   "scripts": {
     "typecheck": "tsc --noEmit",
-    "lint": "biome check .",
-    "format": "biome format --write .",
+    "lint": "oxlint && oxfmt --check",
+    "lint:fix": "oxlint --fix && oxfmt",
+    "format": "oxfmt",
     "clean": "git clean -dfX",
+    "prepare": "lefthook install || true",
     "release": "semantic-release",
     "build": "bun run typecheck && bob build",
-    "codegen": "nitrogen --logLevel=\"debug\" && bun run build"
+    "codegen": "nitrogen --logLevel=\"debug\" && bun run build",
+    "verify:blur": "swiftc -O -o \"${TMPDIR:-/tmp}/nitro-verify-blur\" scripts/verify-blur.swift ios/GaussianBlur.swift && \"${TMPDIR:-/tmp}/nitro-verify-blur\""
   },
   "keywords": [
     "react-native",
@@ -59,26 +62,28 @@
     "registry": "https://registry.npmjs.org/"
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.6",
     "@semantic-release/changelog": "^7.0.0",
     "@semantic-release/git": "^11.0.1",
-    "@types/bun": "^1.3.14",
+    "@types/bun": "^1.4.0",
     "@types/jest": "^30.0.0",
     "@types/react": "19.2.18",
-    "conventional-changelog-conventionalcommits": "^10.2.1",
-    "nitrogen": "0.36.5",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "lefthook": "^2.1.10",
+    "nitrogen": "0.37.0",
+    "oxfmt": "^0.65.0",
+    "oxlint": "^1.80.0",
     "react": "19.2.3",
     "react-native": "0.84.1",
     "react-native-builder-bob": "^0.43.0",
-    "react-native-nitro-modules": "0.36.5",
-    "semantic-release": "^25.0.8",
-    "typescript": "^5.8.3"
+    "react-native-nitro-modules": "0.37.0",
+    "semantic-release": "^25.0.9",
+    "typescript": "^7.0.2"
   },
   "peerDependencies": {
     "react": "*",
     "react-native": "*",
     "react-native-nitro-modules": "*",
-    "react-native-nitro-image": "*"
+    "react-native-nitro-image": "0.15.1"
   },
   "overrides": {
     "lodash-es": "4.17.21"
@@ -96,5 +101,8 @@
         }
       ]
     ]
-  }
+  },
+  "trustedDependencies": [
+    "lefthook"
+  ]
 }

package/src/index.ts

@@ -4,11 +4,12 @@ import { NitroModules } from 'react-native-nitro-modules';
 
 import type {
   CacheOption,
+  CornerRadii,
   NitroImagePipeline as NitroImagePipelineSpec,
   Options,
 } from './specs/nitro-image-toolkit.nitro';
 
-export type { CacheOption, Options };
+export type { CacheOption, CornerRadii, Options };
 
 export const NitroImagePipeline =
   NitroModules.createHybridObject<NitroImagePipelineSpec>('NitroImagePipeline');
@@ -45,8 +46,18 @@ export function useImage({
   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`.
+   */
   blur?: number;
-  cornerRadius?: 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).
+   */
+  cornerRadius?: number | CornerRadii;
   cache?: CacheOption;
 }): Result {
   const [image, setImage] = useState<Result>({
@@ -55,6 +66,17 @@ export function useImage({
   });
   const loadedUrlRef = useRef(url);
 
+  // Split the option into primitives so an inline `{ topLeft: 24, ... }`
+  // literal (new identity every render) doesn't re-trigger the effect.
+  const isUniformRadius = typeof cornerRadius === 'number';
+  const uniformRadius = isUniformRadius ? cornerRadius : 0;
+  const {
+    topLeft = 0,
+    topRight = 0,
+    bottomLeft = 0,
+    bottomRight = 0,
+  } = isUniformRadius ? {} : cornerRadius;
+
   useEffect(() => {
     let cancelled = false;
     // Only reset to the loading state when the URL changes; for same-URL
@@ -69,7 +91,9 @@ export function useImage({
       try {
         const result = await NitroImagePipeline.loadImage(url, {
           blur,
-          cornerRadius,
+          cornerRadius: isUniformRadius
+            ? uniformRadius
+            : { topLeft, topRight, bottomLeft, bottomRight },
           cache,
         });
 
@@ -87,7 +111,17 @@ export function useImage({
     return () => {
       cancelled = true;
     };
-  }, [url, blur, cornerRadius, cache]);
+  }, [
+    url,
+    blur,
+    isUniformRadius,
+    uniformRadius,
+    topLeft,
+    topRight,
+    bottomLeft,
+    bottomRight,
+    cache,
+  ]);
 
   return image;
 }

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

@@ -2,17 +2,52 @@ 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.
+ */
+export interface CornerRadii {
+  topLeft?: number;
+  topRight?: number;
+  bottomLeft?: number;
+  bottomRight?: 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.
+   *
+   * React Native's `<Image blurRadius={n} />` is roughly `blur: n / 2`.
+   *
+   * @default 0 (no blur)
+   */
   blur?: number;
   cache?: CacheOption;
-  cornerRadius?: number;
+  /**
+   * 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).
+   *
+   * @default 0 (square corners)
+   */
+  cornerRadius?: number | CornerRadii;
 };
 
-export interface NitroImagePipeline
-  extends HybridObject<{ ios: 'swift'; android: 'kotlin' }> {
+export interface NitroImagePipeline extends HybridObject<{
+  ios: 'swift';
+  android: 'kotlin';
+}> {
   loadImage(url: string, options?: Options): Promise<Image>;
   preLoadImage(url: string): Promise<void>;
   preLoadImages(urls: string[]): Promise<void>;
+  /**
+   * Blurs an already-loaded image. `radius` is the standard deviation (sigma)
+   * of the Gaussian in **source-image pixels**, the same unit as
+   * {@linkcode Options.blur}.
+   */
   gaussianBlur(image: Image, radius: number): Promise<Image>;
   // Future: brightness, saturation, tint, etc.