react-native-libyuv-resizer 0.2.0

package/ios/LibyuvResizer.mm

@@ -0,0 +1,31 @@
+#import "LibyuvResizer.h"
+
+@implementation LibyuvResizer
+
+RCT_EXPORT_MODULE(LibyuvResizer)
+
+RCT_EXPORT_METHOD(resize:(NSString *)filePath
+                  targetWidth:(double)targetWidth
+                  targetHeight:(double)targetHeight
+                  quality:(double)quality
+                  rotation:(double)rotation
+                  mode:(NSString *)mode
+                  outputPath:(NSString *)outputPath
+                  filterMode:(NSString *)filterMode
+                  keepMeta:(BOOL)keepMeta
+                  format:(NSString *)format
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(RCTPromiseRejectBlock)reject)
+{
+    (void)keepMeta;
+    (void)format;
+    reject(@"E_NOT_IMPLEMENTED", @"resize is not yet implemented on iOS", nil);
+}
+
+- (std::shared_ptr<facebook::react::TurboModule>)getTurboModule:
+    (const facebook::react::ObjCTurboModule::InitParams &)params
+{
+    return std::make_shared<facebook::react::NativeLibyuvResizerSpecJSI>(params);
+}
+
+@end

package/lib/module/NativeLibyuvResizer.js

@@ -0,0 +1,28 @@
+"use strict";
+
+import { NativeModules, TurboModuleRegistry } from 'react-native';
+
+/**
+ * Metadata returned by the native `resize()` bridge call.
+ *
+ * All numeric fields reflect the **output** file / bitmap — not the source.
+ */
+
+/**
+ * Turbo Module contract for the native `LibyuvResizer` implementation.
+ *
+ * **Do not call this interface directly.** Use the public {@link resize}
+ * function from `./resizer` (or the package root) instead — it validates
+ * arguments and applies sensible defaults before forwarding to this bridge.
+ *
+ * This interface is consumed by React Native codegen to auto-generate the
+ * JSI glue code (`LibyuvResizerSpec`).
+ */
+
+const isTurboModuleEnabled = globalThis.__turboModuleProxy != null;
+const LibyuvResizerModule = isTurboModuleEnabled ? TurboModuleRegistry.getEnforcing('LibyuvResizer') : NativeModules.LibyuvResizer;
+if (!LibyuvResizerModule) {
+  throw new Error('react-native-libyuv-resizer: native module not found. Did you forget to link the library?');
+}
+export default LibyuvResizerModule;
+//# sourceMappingURL=NativeLibyuvResizer.js.map

package/lib/module/NativeLibyuvResizer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeModules","TurboModuleRegistry","isTurboModuleEnabled","globalThis","__turboModuleProxy","LibyuvResizerModule","getEnforcing","LibyuvResizer","Error"],"sourceRoot":"..\\..\\src","sources":["NativeLibyuvResizer.ts"],"mappings":";;AAAA,SACEA,aAAa,EACbC,mBAAmB,QAEd,cAAc;;AAErB;AACA;AACA;AACA;AACA;;AAgBA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAgCA,MAAMC,oBAAoB,GACvBC,UAAU,CAA6BC,kBAAkB,IAAI,IAAI;AAEpE,MAAMC,mBAAyB,GAAGH,oBAAoB,GAClDD,mBAAmB,CAACK,YAAY,CAAO,eAAe,CAAC,GACtDN,aAAa,CAACO,aAAsB;AAEzC,IAAI,CAACF,mBAAmB,EAAE;EACxB,MAAM,IAAIG,KAAK,CACb,2FACF,CAAC;AACH;AAEA,eAAeH,mBAAmB","ignoreList":[]}

package/lib/module/index.js

@@ -0,0 +1,20 @@
+"use strict";
+
+/**
+ * `react-native-libyuv-resizer` — high-performance image resizer for React
+ * Native backed by libyuv on Android.
+ *
+ * **Entry point.** Import {@link resize} and the supporting types from here.
+ *
+ * @example
+ * ```ts
+ * import { resize } from 'react-native-libyuv-resizer';
+ *
+ * const result = await resize('/path/to/photo.jpg', 1280, 720, 85);
+ * console.log(result.path, result.width, result.height);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { resize } from './resizer';
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resize"],"sourceRoot":"..\\..\\src","sources":["index.tsx"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASA,MAAM,QAAQ,WAAW","ignoreList":[]}

package/lib/module/package.json

@@ -0,0 +1 @@
+{"type":"module"}

package/lib/module/resizer.js

@@ -0,0 +1,15 @@
+"use strict";
+
+/**
+ * Web / non-native fallback for {@link resize}.
+ *
+ * This module is selected by Metro on platforms other than Android/iOS.
+ * It always rejects because `react-native-libyuv-resizer` requires a native
+ * runtime. Import the real implementation via the `.native` platform extension.
+ *
+ * @throws {Error} Always — native platform required.
+ */
+export function resize(_filePath, _targetWidth, _targetHeight, _quality, _options) {
+  return Promise.reject(new Error("'react-native-libyuv-resizer' is only supported on native platforms."));
+}
+//# sourceMappingURL=resizer.js.map

package/lib/module/resizer.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["resize","_filePath","_targetWidth","_targetHeight","_quality","_options","Promise","reject","Error"],"sourceRoot":"..\\..\\src","sources":["resizer.tsx"],"mappings":";;AASA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASA,MAAMA,CACpBC,SAAiB,EACjBC,YAAoB,EACpBC,aAAqB,EACrBC,QAAgB,EAChBC,QAAwB,EACD;EACvB,OAAOC,OAAO,CAACC,MAAM,CACnB,IAAIC,KAAK,CACP,sEACF,CACF,CAAC;AACH","ignoreList":[]}

package/lib/module/resizer.native.js

@@ -0,0 +1,110 @@
+"use strict";
+
+import LibyuvResizer from "./NativeLibyuvResizer.js";
+
+/**
+ * Valid rotation values in degrees.
+ * Negative angles are normalised to their positive equivalents before being
+ * sent to the native layer (`-90` → `270`, etc.).
+ */
+
+/**
+ * Controls how the source image is fitted into the target bounding box.
+ *
+ * - `'contain'` — scales uniformly so the entire image fits within the box,
+ *   preserving aspect ratio. Empty space is left uncropped.
+ * - `'cover'` — scales uniformly so the image fills the box, preserving
+ *   aspect ratio. Excess pixels are cropped.
+ * - `'stretch'` — scales to exactly `targetWidth × targetHeight`, ignoring
+ *   aspect ratio.
+ */
+
+/**
+ * Scaling filter applied during the resize operation.
+ *
+ * Higher quality filters are slower. Choose based on your latency vs quality
+ * requirements.
+ *
+ * - `'none'` — nearest-neighbour; fastest, lowest quality.
+ * - `'linear'` — linear interpolation.
+ * - `'bilinear'` — bilinear interpolation.
+ * - `'box'` — box filter; best quality for downscaling *(default)*.
+ */
+
+/**
+ * Output image format.
+ *
+ * When omitted, format is derived from `quality`: `quality === 100` → `'png'`, else `'jpeg'`.
+ * When specified, this value takes precedence over the quality-based heuristic.
+ *
+ * - `'jpeg'` — lossy JPEG.
+ * - `'png'`  — lossless PNG. `quality` is ignored.
+ * - `'webp'` — lossy WebP. `quality` controls compression level *(Android only; iOS produces JPEG)*.
+ */
+
+/** Options accepted by {@link resize}. */
+
+const VALID_MODES = ['contain', 'cover', 'stretch'];
+const VALID_FILTER_MODES = ['none', 'linear', 'bilinear', 'box'];
+const VALID_FORMATS = ['jpeg', 'png', 'webp'];
+
+/** Normalises negative or out-of-range angles to 0 | 90 | 180 | 270. */
+function toCanonicalAngle(angle) {
+  return (angle % 360 + 360) % 360;
+}
+
+/**
+ * Resizes an image using the libyuv native backend (Android).
+ *
+ * The source image is read from `filePath`, resized to the requested
+ * dimensions, and saved as a JPEG. The absolute path of the output file is
+ * returned on success.
+ *
+ * @param filePath - Absolute path to the source image.
+ * @param targetWidth - Output width in pixels (must be > 0).
+ * @param targetHeight - Output height in pixels (must be > 0).
+ * @param quality - JPEG encoding quality from `1` (lowest) to `100` (highest).
+ *   Use `100` to produce PNG output instead of JPEG.
+ * @param options - Optional resize behaviour overrides.
+ * @returns A `Promise` that resolves to a {@link ResizeResult} with the output
+ *   file path, URI, size, name, and dimensions.
+ * @throws {TypeError} When `options.mode` or `options.filterMode` is not one
+ *   of the accepted string literals.
+ *
+ * @example
+ * ```ts
+ * // Basic resize
+ * const result = await resize('/path/to/photo.jpg', 1280, 720, 85);
+ * console.log(result.path, result.width, result.height);
+ *
+ * // With options
+ * const result = await resize('/path/to/photo.jpg', 800, 600, 80, {
+ *   rotation: 90,
+ *   mode: 'cover',
+ *   filterMode: 'bilinear',
+ *   outputPath: '/path/to/output-dir',
+ * });
+ *
+ * // Preserve EXIF (GPS, camera, date) — Android only
+ * const result = await resize('/path/to/photo.jpg', 800, 600, 80, {
+ *   keepMeta: true,
+ * });
+ * ```
+ */
+export function resize(filePath, targetWidth, targetHeight, quality, options) {
+  const rotation = options?.rotation != null ? toCanonicalAngle(options.rotation) : 0;
+  const mode = options?.mode ?? 'contain';
+  if (!VALID_MODES.includes(mode)) {
+    return Promise.reject(new TypeError(`Invalid resize mode: '${mode}'`));
+  }
+  const filterMode = options?.filterMode ?? 'box';
+  if (!VALID_FILTER_MODES.includes(filterMode)) {
+    return Promise.reject(new TypeError(`Invalid filter mode: '${filterMode}'`));
+  }
+  const format = options?.format ?? (quality === 100 ? 'png' : 'jpeg');
+  if (!VALID_FORMATS.includes(format)) {
+    return Promise.reject(new TypeError(`Invalid format: '${format}'`));
+  }
+  return LibyuvResizer.resize(filePath, targetWidth, targetHeight, quality, rotation, mode, options?.outputPath ?? '', filterMode, options?.keepMeta ?? false, format);
+}
+//# sourceMappingURL=resizer.native.js.map

package/lib/module/resizer.native.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["LibyuvResizer","VALID_MODES","VALID_FILTER_MODES","VALID_FORMATS","toCanonicalAngle","angle","resize","filePath","targetWidth","targetHeight","quality","options","rotation","mode","includes","Promise","reject","TypeError","filterMode","format","outputPath","keepMeta"],"sourceRoot":"..\\..\\src","sources":["resizer.native.tsx"],"mappings":";;AAAA,OAAOA,aAAa,MAA6B,0BAAuB;;AAIxE;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;;AAGA;;AA2CA,MAAMC,WAAyB,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC;AACjE,MAAMC,kBAAgC,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,KAAK,CAAC;AAC9E,MAAMC,aAA6B,GAAG,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;;AAE7D;AACA,SAASC,gBAAgBA,CAACC,KAAoB,EAAsB;EAClE,OAAQ,CAAEA,KAAK,GAAG,GAAG,GAAI,GAAG,IAAI,GAAG;AACrC;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,OAAO,SAASC,MAAMA,CACpBC,QAAgB,EAChBC,WAAmB,EACnBC,YAAoB,EACpBC,OAAe,EACfC,OAAuB,EACA;EACvB,MAAMC,QAAQ,GACZD,OAAO,EAAEC,QAAQ,IAAI,IAAI,GAAGR,gBAAgB,CAACO,OAAO,CAACC,QAAQ,CAAC,GAAG,CAAC;EACpE,MAAMC,IAAgB,GAAGF,OAAO,EAAEE,IAAI,IAAI,SAAS;EACnD,IAAI,CAACZ,WAAW,CAACa,QAAQ,CAACD,IAAI,CAAC,EAAE;IAC/B,OAAOE,OAAO,CAACC,MAAM,CAAC,IAAIC,SAAS,CAAC,yBAAyBJ,IAAI,GAAG,CAAC,CAAC;EACxE;EACA,MAAMK,UAAsB,GAAGP,OAAO,EAAEO,UAAU,IAAI,KAAK;EAC3D,IAAI,CAAChB,kBAAkB,CAACY,QAAQ,CAACI,UAAU,CAAC,EAAE;IAC5C,OAAOH,OAAO,CAACC,MAAM,CACnB,IAAIC,SAAS,CAAC,yBAAyBC,UAAU,GAAG,CACtD,CAAC;EACH;EACA,MAAMC,MAAoB,GACxBR,OAAO,EAAEQ,MAAM,KAAKT,OAAO,KAAK,GAAG,GAAG,KAAK,GAAG,MAAM,CAAC;EACvD,IAAI,CAACP,aAAa,CAACW,QAAQ,CAACK,MAAM,CAAC,EAAE;IACnC,OAAOJ,OAAO,CAACC,MAAM,CAAC,IAAIC,SAAS,CAAC,oBAAoBE,MAAM,GAAG,CAAC,CAAC;EACrE;EACA,OAAOnB,aAAa,CAACM,MAAM,CACzBC,QAAQ,EACRC,WAAW,EACXC,YAAY,EACZC,OAAO,EACPE,QAAQ,EACRC,IAAI,EACJF,OAAO,EAAES,UAAU,IAAI,EAAE,EACzBF,UAAU,EACVP,OAAO,EAAEU,QAAQ,IAAI,KAAK,EAC1BF,MACF,CAAC;AACH","ignoreList":[]}

package/lib/typescript/package.json

@@ -0,0 +1 @@
+{"type":"module"}

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

@@ -0,0 +1,52 @@
+import { type TurboModule } from 'react-native';
+/**
+ * Metadata returned by the native `resize()` bridge call.
+ *
+ * All numeric fields reflect the **output** file / bitmap — not the source.
+ */
+export type ResizeResult = {
+    /** Absolute path of the resized image file. */
+    path: string;
+    /** `file://` URI of the resized image file. */
+    uri: string;
+    /** File size in bytes. */
+    size: number;
+    /** File name (e.g. `"a3f2…1c.jpg"`). */
+    name: string;
+    /** Output bitmap width in pixels. */
+    width: number;
+    /** Output bitmap height in pixels. */
+    height: number;
+};
+/**
+ * Turbo Module contract for the native `LibyuvResizer` implementation.
+ *
+ * **Do not call this interface directly.** Use the public {@link resize}
+ * function from `./resizer` (or the package root) instead — it validates
+ * arguments and applies sensible defaults before forwarding to this bridge.
+ *
+ * This interface is consumed by React Native codegen to auto-generate the
+ * JSI glue code (`LibyuvResizerSpec`).
+ */
+export interface Spec extends TurboModule {
+    /**
+     * Low-level bridge method. Parameter order mirrors the public `resize()`
+     * signature with defaults already resolved.
+     *
+     * @param filePath    - Absolute path to the source image.
+     * @param targetWidth - Output width in pixels.
+     * @param targetHeight - Output height in pixels.
+     * @param quality     - JPEG/WebP quality `0–100`.
+     * @param rotation    - Canonical rotation in degrees (`0 | 90 | 180 | 270`).
+     * @param mode        - Resize mode string (`'contain' | 'cover' | 'stretch'`).
+     * @param outputPath  - Absolute output path, or empty string for auto.
+     * @param filterMode  - Scaling filter (`'none' | 'linear' | 'bilinear' | 'box'`).
+     * @param keepMeta    - Copy EXIF tags from source to output (JPEG only, Android only).
+     * @param format      - Output format (`'jpeg' | 'png' | 'webp'`).
+     * @returns Metadata about the resized image.
+     */
+    resize(filePath: string, targetWidth: number, targetHeight: number, quality: number, rotation: number, mode: string, outputPath: string, filterMode: string, keepMeta: boolean, format: string): Promise<ResizeResult>;
+}
+declare const LibyuvResizerModule: Spec;
+export default LibyuvResizerModule;
+//# sourceMappingURL=NativeLibyuvResizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"NativeLibyuvResizer.d.ts","sourceRoot":"","sources":["../../../src/NativeLibyuvResizer.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,+CAA+C;IAC/C,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,GAAG,EAAE,MAAM,CAAC;IACZ,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;;;;GASG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CACJ,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,EACZ,UAAU,EAAE,MAAM,EAClB,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,OAAO,EACjB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B;AAKD,QAAA,MAAM,mBAAmB,EAAE,IAEc,CAAC;AAQ1C,eAAe,mBAAmB,CAAC"}

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

@@ -0,0 +1,19 @@
+/**
+ * `react-native-libyuv-resizer` — high-performance image resizer for React
+ * Native backed by libyuv on Android.
+ *
+ * **Entry point.** Import {@link resize} and the supporting types from here.
+ *
+ * @example
+ * ```ts
+ * import { resize } from 'react-native-libyuv-resizer';
+ *
+ * const result = await resize('/path/to/photo.jpg', 1280, 720, 85);
+ * console.log(result.path, result.width, result.height);
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { resize } from './resizer';
+export type { RotationAngle, ResizeMode, ResizeOptions, ResizeResult, } from './resizer';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/index.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,YAAY,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,WAAW,CAAC"}

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

@@ -0,0 +1,13 @@
+import type { ResizeOptions, ResizeResult } from './resizer.native';
+export type { RotationAngle, ResizeMode, ResizeOptions, ResizeResult, } from './resizer.native';
+/**
+ * Web / non-native fallback for {@link resize}.
+ *
+ * This module is selected by Metro on platforms other than Android/iOS.
+ * It always rejects because `react-native-libyuv-resizer` requires a native
+ * runtime. Import the real implementation via the `.native` platform extension.
+ *
+ * @throws {Error} Always — native platform required.
+ */
+export declare function resize(_filePath: string, _targetWidth: number, _targetHeight: number, _quality: number, _options?: ResizeOptions): Promise<ResizeResult>;
+//# sourceMappingURL=resizer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"resizer.d.ts","sourceRoot":"","sources":["../../../src/resizer.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAEpE,YAAY,EACV,aAAa,EACb,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B;;;;;;;;GAQG;AACH,wBAAgB,MAAM,CACpB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,aAAa,EAAE,MAAM,EACrB,QAAQ,EAAE,MAAM,EAChB,QAAQ,CAAC,EAAE,aAAa,GACvB,OAAO,CAAC,YAAY,CAAC,CAMvB"}

package/lib/typescript/src/resizer.native.d.ts

@@ -0,0 +1,119 @@
+import { type ResizeResult } from './NativeLibyuvResizer';
+export type { ResizeResult };
+/**
+ * Valid rotation values in degrees.
+ * Negative angles are normalised to their positive equivalents before being
+ * sent to the native layer (`-90` → `270`, etc.).
+ */
+export type RotationAngle = 0 | 90 | 180 | 270 | -90 | -180 | -270;
+/**
+ * Controls how the source image is fitted into the target bounding box.
+ *
+ * - `'contain'` — scales uniformly so the entire image fits within the box,
+ *   preserving aspect ratio. Empty space is left uncropped.
+ * - `'cover'` — scales uniformly so the image fills the box, preserving
+ *   aspect ratio. Excess pixels are cropped.
+ * - `'stretch'` — scales to exactly `targetWidth × targetHeight`, ignoring
+ *   aspect ratio.
+ */
+export type ResizeMode = 'contain' | 'cover' | 'stretch';
+/**
+ * Scaling filter applied during the resize operation.
+ *
+ * Higher quality filters are slower. Choose based on your latency vs quality
+ * requirements.
+ *
+ * - `'none'` — nearest-neighbour; fastest, lowest quality.
+ * - `'linear'` — linear interpolation.
+ * - `'bilinear'` — bilinear interpolation.
+ * - `'box'` — box filter; best quality for downscaling *(default)*.
+ */
+export type FilterMode = 'none' | 'linear' | 'bilinear' | 'box';
+/**
+ * Output image format.
+ *
+ * When omitted, format is derived from `quality`: `quality === 100` → `'png'`, else `'jpeg'`.
+ * When specified, this value takes precedence over the quality-based heuristic.
+ *
+ * - `'jpeg'` — lossy JPEG.
+ * - `'png'`  — lossless PNG. `quality` is ignored.
+ * - `'webp'` — lossy WebP. `quality` controls compression level *(Android only; iOS produces JPEG)*.
+ */
+export type OutputFormat = 'jpeg' | 'png' | 'webp';
+/** Options accepted by {@link resize}. */
+export interface ResizeOptions {
+    /**
+     * Clockwise rotation applied to the image **before** resizing.
+     * @default 0
+     */
+    rotation?: RotationAngle;
+    /**
+     * How the image is fitted into the target bounding box.
+     * @default 'contain'
+     */
+    mode?: ResizeMode;
+    /**
+     * Scaling filter used during the resize operation.
+     * @default 'box'
+     */
+    filterMode?: FilterMode;
+    /**
+     * Absolute path for the output file.
+     * When omitted the native layer generates a path in the app's cache
+     * directory automatically.
+     */
+    outputPath?: string;
+    /**
+     * When `true`, copies all EXIF tags from the source image to the output
+     * JPEG. Has no effect on PNG or WebP output, or on iOS (no-op).
+     * @default false
+     * @platform android
+     */
+    keepMeta?: boolean;
+    /**
+     * Output image format. When omitted, `quality === 100` produces PNG; otherwise JPEG.
+     * Specifying `format` takes precedence over the quality-based heuristic.
+     * @default derived from quality
+     */
+    format?: OutputFormat;
+}
+/**
+ * Resizes an image using the libyuv native backend (Android).
+ *
+ * The source image is read from `filePath`, resized to the requested
+ * dimensions, and saved as a JPEG. The absolute path of the output file is
+ * returned on success.
+ *
+ * @param filePath - Absolute path to the source image.
+ * @param targetWidth - Output width in pixels (must be > 0).
+ * @param targetHeight - Output height in pixels (must be > 0).
+ * @param quality - JPEG encoding quality from `1` (lowest) to `100` (highest).
+ *   Use `100` to produce PNG output instead of JPEG.
+ * @param options - Optional resize behaviour overrides.
+ * @returns A `Promise` that resolves to a {@link ResizeResult} with the output
+ *   file path, URI, size, name, and dimensions.
+ * @throws {TypeError} When `options.mode` or `options.filterMode` is not one
+ *   of the accepted string literals.
+ *
+ * @example
+ * ```ts
+ * // Basic resize
+ * const result = await resize('/path/to/photo.jpg', 1280, 720, 85);
+ * console.log(result.path, result.width, result.height);
+ *
+ * // With options
+ * const result = await resize('/path/to/photo.jpg', 800, 600, 80, {
+ *   rotation: 90,
+ *   mode: 'cover',
+ *   filterMode: 'bilinear',
+ *   outputPath: '/path/to/output-dir',
+ * });
+ *
+ * // Preserve EXIF (GPS, camera, date) — Android only
+ * const result = await resize('/path/to/photo.jpg', 800, 600, 80, {
+ *   keepMeta: true,
+ * });
+ * ```
+ */
+export declare function resize(filePath: string, targetWidth: number, targetHeight: number, quality: number, options?: ResizeOptions): Promise<ResizeResult>;
+//# sourceMappingURL=resizer.native.d.ts.map

package/lib/typescript/src/resizer.native.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resizer.native.d.ts","sourceRoot":"","sources":["../../../src/resizer.native.tsx"],"names":[],"mappings":"AAAA,OAAsB,EAAE,KAAK,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAEzE,YAAY,EAAE,YAAY,EAAE,CAAC;AAE7B;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,GAAG,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC,EAAE,GAAG,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC;AAEnE;;;;;;;;;GASG;AACH,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;AAEzD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,UAAU,GAAG,KAAK,CAAC;AAEhE;;;;;;;;;GASG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAEnD,0CAA0C;AAC1C,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,QAAQ,CAAC,EAAE,aAAa,CAAC;IAEzB;;;OAGG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;;OAGG;IACH,UAAU,CAAC,EAAE,UAAU,CAAC;IAExB;;;;OAIG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;;;;OAKG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IAEnB;;;;OAIG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAWD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAgB,MAAM,CACpB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,YAAY,CAAC,CA8BvB"}

package/package.json

@@ -0,0 +1,184 @@
+{
+  "name": "react-native-libyuv-resizer",
+  "version": "0.2.0",
+  "description": "High-performance image resizer for React Native using libyuv (Android, New Architecture)",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.tsx",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "cpp",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-libyuv-resizer-example",
+    "clean": "del-cli android/build example/android/build example/android/app/build example/ios/build lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\"",
+    "test": "jest",
+    "release": "release-it --only-version"
+  },
+  "keywords": [
+    "react-native",
+    "android",
+    "image",
+    "resize",
+    "libyuv",
+    "turbo-module",
+    "new-architecture",
+    "performance"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/anderson-souza/react-native-libyuv-resizer.git"
+  },
+  "author": "Anderson Souza <andersonpds14@gmail.com> (https://github.com/anderson-souza)",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/anderson-souza/react-native-libyuv-resizer/issues"
+  },
+  "homepage": "https://github.com/anderson-souza/react-native-libyuv-resizer#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@jest/globals": "^30.0.0",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@react-native/jest-preset": "0.85.0",
+    "@release-it/conventional-changelog": "^10.0.6",
+    "@types/react": "^19.2.0",
+    "commitlint": "^20.5.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-ft-flow": "^3.0.11",
+    "eslint-plugin-prettier": "^5.5.5",
+    "jest": "^30.3.0",
+    "lefthook": "^2.1.4",
+    "prettier": "^3.8.1",
+    "react": "19.2.3",
+    "react-native": "0.85.0",
+    "react-native-builder-bob": "^0.41.0",
+    "release-it": "^19.2.4",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "codegenConfig": {
+    "name": "LibyuvResizerSpec",
+    "type": "modules",
+    "jsSrcsDir": "src",
+    "android": {
+      "javaPackageName": "com.libyuvresizer"
+    }
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  },
+  "jest": {
+    "preset": "@react-native/jest-preset",
+    "modulePathIgnorePatterns": [
+      "<rootDir>/example/node_modules",
+      "<rootDir>/lib/"
+    ],
+    "coverageThreshold": {
+      "global": {
+        "statements": 85,
+        "branches": 85,
+        "functions": 85,
+        "lines": 85
+      }
+    }
+  },
+  "commitlint": {
+    "extends": [
+      "@commitlint/config-conventional"
+    ]
+  },
+  "release-it": {
+    "git": {
+      "commitMessage": "chore: release ${version}",
+      "tagName": "v${version}"
+    },
+    "npm": {
+      "publish": true
+    },
+    "github": {
+      "release": true
+    },
+    "plugins": {
+      "@release-it/conventional-changelog": {
+        "preset": {
+          "name": "angular"
+        }
+      }
+    }
+  },
+  "create-react-native-library": {
+    "type": "turbo-module",
+    "languages": "kotlin-objc",
+    "tools": [
+      "eslint",
+      "jest",
+      "lefthook",
+      "release-it"
+    ],
+    "version": "0.62.0"
+  }
+}