react-native-nitro-image-pipeline 0.1.1

package/package.json

@@ -0,0 +1,99 @@
+{
+  "name": "react-native-nitro-image-pipeline",
+  "version": "0.1.1",
+  "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",
+  "types": "./lib/typescript/src/index.d.ts",
+  "react-native": "src/index",
+  "source": "src/index",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "biome check .",
+    "format": "biome format --write .",
+    "clean": "git clean -dfX",
+    "release": "semantic-release",
+    "build": "bun run typecheck && bob build",
+    "codegen": "nitrogen --logLevel=\"debug\" && bun run build && node post-script.js"
+  },
+  "keywords": [
+    "react-native",
+    "nitro",
+    "image",
+    "image-loader",
+    "image-cache",
+    "image-processing",
+    "react-native-nitro-image-pipeline"
+  ],
+  "files": [
+    "src",
+    "react-native.config.js",
+    "lib",
+    "nitrogen",
+    "cpp",
+    "nitro.json",
+    "android/build.gradle",
+    "android/fix-prefab.gradle",
+    "android/gradle.properties",
+    "android/CMakeLists.txt",
+    "android/src",
+    "ios/**/*.h",
+    "ios/**/*.m",
+    "ios/**/*.mm",
+    "ios/**/*.cpp",
+    "ios/**/*.swift",
+    "app.plugin.js",
+    "*.podspec",
+    "README.md"
+  ],
+  "workspaces": [
+    "example"
+  ],
+  "repository": "https://github.com/aparedes/react-native-nitro-image-pipeline.git",
+  "author": "aparedes",
+  "license": "MIT",
+  "bugs": "https://github.com/aparedes/react-native-nitro-image-pipeline/issues",
+  "homepage": "https://github.com/aparedes/react-native-nitro-image-pipeline#readme",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.10",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/git": "^10.0.1",
+    "@types/jest": "^29.5.12",
+    "@types/react": "19.2.0",
+    "conventional-changelog-conventionalcommits": "^9.1.0",
+    "nitrogen": "0.35.2",
+    "react": "19.2.3",
+    "react-native": "0.84.1",
+    "react-native-builder-bob": "^0.40.18",
+    "react-native-nitro-modules": "0.35.2",
+    "semantic-release": "^25.0.3",
+    "typescript": "^5.8.3"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-nitro-modules": "*",
+    "react-native-nitro-image": "*"
+  },
+  "overrides": {
+    "lodash-es": "4.17.21"
+  },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  }
+}

package/src/index.ts

@@ -0,0 +1,66 @@
+import { useEffect, useState } from 'react';
+import type { Image } from 'react-native-nitro-image';
+import { NitroModules } from 'react-native-nitro-modules';
+
+import type { NitroImagePipeline as NitroImagePipelineSpec } from './specs/nitro-image-toolkit.nitro';
+
+export const NitroImagePipeline =
+  NitroModules.createHybridObject<NitroImagePipelineSpec>('NitroImagePipeline');
+
+type Result =
+  // Loading State
+  | {
+      image: undefined;
+      error: undefined;
+    }
+  // Loaded state
+  | {
+      image: Image;
+      error: undefined;
+    }
+  // Error state
+  | {
+      image: undefined;
+      error: Error;
+    };
+
+/**
+ * A hook to asynchronously load an image from the
+ * given {@linkcode AsyncImageSource} into memory.
+ * @example
+ * ```ts
+ * const { image, error } = useImage({ filePath: '/tmp/image.jpg' })
+ * ```
+ */
+export function useImage({
+  url,
+  blur = 0,
+  cornerRadius = 0,
+}: {
+  url: string;
+  blur?: number;
+  cornerRadius?: number;
+}): Result {
+  const [image, setImage] = useState<Result>({
+    image: undefined,
+    error: undefined,
+  });
+
+  useEffect(() => {
+    (async () => {
+      try {
+        const result = await NitroImagePipeline.loadImage(url, {
+          blur,
+          cornerRadius,
+        });
+
+        setImage({ image: result, error: undefined });
+      } catch (e) {
+        const error = e instanceof Error ? e : new Error(`${e}`);
+        setImage({ image: undefined, error: error });
+      }
+    })();
+  }, [url, blur]);
+
+  return image;
+}

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

@@ -0,0 +1,16 @@
+import type { Image } from 'react-native-nitro-image';
+import type { HybridObject } from 'react-native-nitro-modules';
+
+type CacheOption = 'memory' | 'disk' | 'none';
+type Options = { blur?: number; cache?: CacheOption; cornerRadius?: number };
+
+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>;
+  gaussianBlur(image: Image, radius: number): Promise<Image>;
+  // Future: brightness, saturation, tint, etc.
+
+  clearCache(): void;
+}