@phucprime/react-native-image-editor 1.0.2 → 1.0.4

package/lib/module/index.js

@@ -0,0 +1,140 @@
+"use strict";
+
+import NativeRNPhotoEditor from './NativeRNPhotoEditor';
+
+/**
+ * Localization strings for the image editor UI.
+ * All fields are optional — unset keys fall back to the English defaults.
+ */
+
+/**
+ * Editor control identifiers that can be hidden via `hiddenControls`.
+ */
+
+/**
+ * Configuration options for the image editor.
+ */
+
+// ─── Defaults ────────────────────────────────────────────────────────────────
+
+/** Built-in 13-colour drawing palette. */
+const DEFAULT_COLORS = ['#000000', '#808080', '#a9a9a9', '#FFFFFE', '#0000ff', '#00ff00', '#ff0000', '#ffff00', '#ffa500', '#800080', '#00ffff', '#a52a2a', '#ff00ff'];
+
+/** Built-in English UI strings. */
+const DEFAULT_LANGUAGES = {
+  doneTitle: 'Done',
+  saveTitle: 'Save',
+  clearAllTitle: 'Clear all',
+  cameraTitle: 'Camera',
+  galleryTitle: 'Gallery',
+  uploadDialogTitle: 'Upload Image',
+  uploadPickerTitle: 'Select Picture',
+  directoryCreateFail: 'Failed to create directory',
+  accessMediaPermissionsMsg: 'To attach photos, we need to access media on your device',
+  continueTxt: 'Continue',
+  notNow: 'NOT NOW',
+  mediaAccessDeniedMsg: 'You denied storage access, no photos will be added.',
+  saveImageSucceed: 'Image saved',
+  eraserTitle: 'Eraser'
+};
+
+// ─── Core native call ─────────────────────────────────────────────────────────
+
+/**
+ * Build the props object and call the native TurboModule.
+ *
+ * The native module exposes a single `edit(props): Promise<string>` method.
+ * This is the only point in the codebase that touches the native boundary,
+ * keeping the public API (open / edit) as thin wrappers.
+ */
+function callNative(config) {
+  const {
+    path,
+    stickers = [],
+    hiddenControls = [],
+    colors = DEFAULT_COLORS,
+    languages
+  } = config;
+  const mergedLanguages = languages ? {
+    ...DEFAULT_LANGUAGES,
+    ...languages
+  } : DEFAULT_LANGUAGES;
+  return NativeRNPhotoEditor.edit({
+    path,
+    colors,
+    hiddenControls,
+    stickers,
+    languages: mergedLanguages
+  });
+}
+
+// ─── Public API ───────────────────────────────────────────────────────────────
+
+/**
+ * React Native Image Editor — native photo editing for iOS and Android.
+ *
+ * Supports the New Architecture (Fabric + TurboModules) and the classic bridge.
+ *
+ * @example
+ * ```ts
+ * // Promise / async-await (recommended)
+ * const saved = await ImageEditor.edit('/path/to/photo.jpg', {
+ *   colors: ['#ff0000', '#00ff00', '#0000ff'],
+ *   stickers: ['heart', 'star'],
+ * });
+ *
+ * // Callback
+ * ImageEditor.open({
+ *   path: '/path/to/photo.jpg',
+ *   onDone:   (path) => console.log('saved:', path),
+ *   onCancel: ()     => console.log('cancelled'),
+ * });
+ * ```
+ */
+class ImageEditor {
+  /**
+   * Edit an image and receive the result via callbacks.
+   *
+   * @param config - Editor configuration including `onDone` / `onCancel`.
+   */
+  static open(config) {
+    callNative(config).then(config.onDone).catch(() => config.onCancel?.());
+  }
+
+  /**
+   * Edit an image and return a Promise.
+   *
+   * Resolves with the saved image path.
+   * Rejects with `{ code: 'CANCELLED' }` when the user dismisses.
+   *
+   * @param path    - Local file path of the image to edit.
+   * @param options - Optional editor configuration (excludes path, onDone, onCancel).
+   */
+  static edit(path, options) {
+    return callNative({
+      ...options,
+      path
+    });
+  }
+
+  /**
+   * @deprecated Use `ImageEditor.open()` instead.
+   */
+  static Edit(config) {
+    ImageEditor.open(config);
+  }
+}
+
+// ─── Exports ──────────────────────────────────────────────────────────────────
+
+/**
+ * @deprecated Use `ImageEditor` instead.
+ */
+const PhotoEditor = ImageEditor;
+export { ImageEditor, PhotoEditor };
+export default ImageEditor;
+
+/** @deprecated Use `ImageEditorConfig` instead. */
+
+/** @deprecated Use `ImageEditorLanguage` instead. */
+//# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["NativeRNPhotoEditor","DEFAULT_COLORS","DEFAULT_LANGUAGES","doneTitle","saveTitle","clearAllTitle","cameraTitle","galleryTitle","uploadDialogTitle","uploadPickerTitle","directoryCreateFail","accessMediaPermissionsMsg","continueTxt","notNow","mediaAccessDeniedMsg","saveImageSucceed","eraserTitle","callNative","config","path","stickers","hiddenControls","colors","languages","mergedLanguages","edit","ImageEditor","open","then","onDone","catch","onCancel","options","Edit","PhotoEditor"],"sourceRoot":"../../src","sources":["index.ts"],"mappings":";;AAAA,OAAOA,mBAAmB,MAAM,uBAAuB;;AAEvD;AACA;AACA;AACA;;AAgCA;AACA;AACA;;AAUA;AACA;AACA;;AAgDA;;AAEA;AACA,MAAMC,cAAwB,GAAG,CAC/B,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,EACT,SAAS,CACV;;AAED;AACA,MAAMC,iBAAgD,GAAG;EACvDC,SAAS,EAAE,MAAM;EACjBC,SAAS,EAAE,MAAM;EACjBC,aAAa,EAAE,WAAW;EAC1BC,WAAW,EAAE,QAAQ;EACrBC,YAAY,EAAE,SAAS;EACvBC,iBAAiB,EAAE,cAAc;EACjCC,iBAAiB,EAAE,gBAAgB;EACnCC,mBAAmB,EAAE,4BAA4B;EACjDC,yBAAyB,EACvB,0DAA0D;EAC5DC,WAAW,EAAE,UAAU;EACvBC,MAAM,EAAE,SAAS;EACjBC,oBAAoB,EAAE,qDAAqD;EAC3EC,gBAAgB,EAAE,aAAa;EAC/BC,WAAW,EAAE;AACf,CAAC;;AAED;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,UAAUA,CAACC,MAAyB,EAAmB;EAC9D,MAAM;IACJC,IAAI;IACJC,QAAQ,GAAG,EAAE;IACbC,cAAc,GAAG,EAAE;IACnBC,MAAM,GAAGrB,cAAc;IACvBsB;EACF,CAAC,GAAGL,MAAM;EAEV,MAAMM,eAA8C,GAAGD,SAAS,GAC5D;IAAE,GAAGrB,iBAAiB;IAAE,GAAGqB;EAAU,CAAC,GACtCrB,iBAAiB;EAErB,OAAOF,mBAAmB,CAACyB,IAAI,CAAC;IAC9BN,IAAI;IACJG,MAAM;IACND,cAAc;IACdD,QAAQ;IACRG,SAAS,EAAEC;EACb,CAAC,CAAC;AACJ;;AAEA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAME,WAAW,CAAC;EAChB;AACF;AACA;AACA;AACA;EACE,OAAOC,IAAIA,CAACT,MAAyB,EAAQ;IAC3CD,UAAU,CAACC,MAAM,CAAC,CAACU,IAAI,CAACV,MAAM,CAACW,MAAM,CAAC,CAACC,KAAK,CAAC,MAAMZ,MAAM,CAACa,QAAQ,GAAG,CAAC,CAAC;EACzE;;EAEA;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;EACE,OAAON,IAAIA,CACTN,IAAY,EACZa,OAAiE,EAChD;IACjB,OAAOf,UAAU,CAAC;MAAE,GAAGe,OAAO;MAAEb;IAAK,CAAC,CAAC;EACzC;;EAEA;AACF;AACA;EACE,OAAOc,IAAIA,CAACf,MAAyB,EAAQ;IAC3CQ,WAAW,CAACC,IAAI,CAACT,MAAM,CAAC;EAC1B;AACF;;AAEA;;AAEA;AACA;AACA;AACA,MAAMgB,WAAW,GAAGR,WAAW;AAE/B,SAASA,WAAW,EAAEQ,WAAW;AACjC,eAAeR,WAAW;;AAE1B;;AAEA","ignoreList":[]}

package/lib/typescript/NativeRNPhotoEditor.d.ts

@@ -0,0 +1,46 @@
+import type { TurboModule } from 'react-native';
+/**
+ * `UnsafeObject` is the codegen-recognised passthrough type for an untyped JS
+ * object parameter.  The React Native codegen AST parser matches on the name
+ * "UnsafeObject" in the source and maps it to NSDictionary* (iOS) /
+ * ReadableMap (Android).
+ *
+ * It must be declared as an empty object type `{}` — NOT as `Record<string, any>`,
+ * which the codegen parser rejects with "Unrecognised generic type 'Record'".
+ * The tsc compiler accepts `{}` fine for this purpose.
+ */
+type UnsafeObject = {};
+/**
+ * TurboModule codegen spec for RNPhotoEditor.
+ *
+ * Design notes
+ * ────────────
+ * • `props` is typed as `UnsafeObject` — the correct codegen-recognised alias
+ *   for an untyped JS object. Using plain `Object` is rejected by the strict
+ *   codegen validator in React Native 0.74+.
+ *
+ * • The method returns `Promise<string>` instead of accepting two `Callback`
+ *   parameters. `Callback` parameters are unsafe on New Architecture because
+ *   they are backed by a `CallbackHolder` tied to the current JS context; if
+ *   the JS context reloads while the native Activity / ViewController is open
+ *   (Fast Refresh, error boundary recovery) the stored block/lambda becomes
+ *   dangling. A `Promise` is resolved or rejected by the native side exactly
+ *   once and is safe across context reloads.
+ *
+ * • On Old Architecture `TurboModuleRegistry.getEnforcing` falls through to
+ *   the `NativeModules` bridge automatically (RN ≥ 0.73), so no separate
+ *   bridge registration is needed.
+ */
+export interface Spec extends TurboModule {
+    /**
+     * Open the native photo editor.
+     *
+     * @param props - Editor configuration object (path, colors, stickers, …).
+     * @returns Promise that resolves with the saved image path, or rejects with
+     *          code "CANCELLED" when the user dismisses without saving.
+     */
+    edit(props: UnsafeObject): Promise<string>;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeRNPhotoEditor.d.ts.map

package/lib/typescript/NativeRNPhotoEditor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NativeRNPhotoEditor.d.ts","sourceRoot":"","sources":["../../src/NativeRNPhotoEditor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAGhD;;;;;;;;;GASG;AAEH,KAAK,YAAY,GAAG,EAAE,CAAC;AAEvB;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC;;;;;;OAMG;IACH,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAC5C;;AAED,wBAAuE"}

package/lib/{index.d.ts → typescript/index.d.ts}

@@ -1,5 +1,6 @@
 /**
  * Localization strings for the image editor UI.
+ * All fields are optional — unset keys fall back to the English defaults.
  */
 export interface ImageEditorLanguage {
     /** Title for the "Done" button */
@@ -31,89 +32,98 @@ export interface ImageEditorLanguage {
     /** Title for the "Eraser" tool */
     eraserTitle?: string;
 }
-/** Editor control types that can be shown or hidden. */
+/**
+ * Editor control identifiers that can be hidden via `hiddenControls`.
+ */
 export type EditorControl = 'text' | 'clear' | 'draw' | 'save' | 'share' | 'sticker' | 'crop';
 /**
  * Configuration options for the image editor.
  */
 export interface ImageEditorConfig {
-    /** Path to the image file to edit (required). */
+    /**
+     * Local file path (or file:// URI) of the image to edit.
+     * The editor overwrites this file when the user taps Done.
+     */
     path: string;
     /**
-     * Array of hex color strings available for drawing and text.
-     * @default ['#000000', '#808080', '#a9a9a9', '#FFFFFE', '#0000ff', '#00ff00', '#ff0000', '#ffff00', '#ffa500', '#800080', '#00ffff', '#a52a2a', '#ff00ff']
+     * Hex color strings for the drawing and text colour picker.
+     * Accepts #RGB, #RRGGBB, and #AARRGGBB formats.
+     * @default DEFAULT_COLORS (13-colour palette)
      */
     colors?: string[];
     /**
-     * Array of sticker image names to show in the sticker picker.
-     * Images must be added to native project resources.
-     * - iOS: Add to Resources folder
-     * - Android: Add to drawable folder
+     * Sticker image names from native resources.
+     * iOS: main bundle image names. Android: res/drawable/ file names (no extension).
      * @default []
      */
     stickers?: string[];
     /**
-     * Array of editor controls to hide.
+     * Controls to remove from the editor toolbar.
      * @default []
      */
     hiddenControls?: EditorControl[];
     /**
-     * Localization strings for the editor UI.
+     * Localization overrides for editor UI strings.
+     * Unset keys fall back to English defaults.
      */
     languages?: ImageEditorLanguage;
     /**
-     * Callback invoked when editing is complete.
-     * @param imagePath - The path to the edited image file.
+     * Called when the user saves the edited image.
+     * `imagePath` is the local path to the overwritten file.
+     * Only used by `ImageEditor.open()` — ignored by `ImageEditor.edit()`.
      */
     onDone?: (imagePath: string) => void;
     /**
-     * Callback invoked when editing is cancelled.
-     * @param resultCode - The native result code.
+     * Called when the user dismisses without saving.
+     * Only used by `ImageEditor.open()` — ignored by `ImageEditor.edit()`.
      */
-    onCancel?: (resultCode: number) => void;
+    onCancel?: () => void;
 }
 /**
- * React Native Image Editor - Native photo editing bridge for iOS and Android.
+ * React Native Image Editor — native photo editing for iOS and Android.
+ *
+ * Supports the New Architecture (Fabric + TurboModules) and the classic bridge.
  *
  * @example
  * ```ts
- * import { ImageEditor } from '@phucprime/react-native-image-editor';
- *
- * // Callback-based usage
- * ImageEditor.open({
- *   path: '/path/to/image.jpg',
- *   onDone: (editedPath) => console.log('Edited:', editedPath),
- *   onCancel: () => console.log('Cancelled'),
+ * // Promise / async-await (recommended)
+ * const saved = await ImageEditor.edit('/path/to/photo.jpg', {
+ *   colors: ['#ff0000', '#00ff00', '#0000ff'],
+ *   stickers: ['heart', 'star'],
  * });
  *
- * // Promise-based usage
- * const editedPath = await ImageEditor.edit('/path/to/image.jpg', {
- *   colors: ['#ff0000', '#00ff00', '#0000ff'],
+ * // Callback
+ * ImageEditor.open({
+ *   path: '/path/to/photo.jpg',
+ *   onDone:   (path) => console.log('saved:', path),
+ *   onCancel: ()     => console.log('cancelled'),
  * });
  * ```
  */
 declare class ImageEditor {
     /**
-     * Open the image editor with callback-based API.
+     * Edit an image and receive the result via callbacks.
      *
-     * @param config - Editor configuration options.
+     * @param config - Editor configuration including `onDone` / `onCancel`.
      */
     static open(config: ImageEditorConfig): void;
     /**
-     * Edit an image and return a promise with the edited image path.
+     * Edit an image and return a Promise.
+     *
+     * Resolves with the saved image path.
+     * Rejects with `{ code: 'CANCELLED' }` when the user dismisses.
      *
-     * @param path - Path to the image file to edit.
-     * @param options - Optional editor configuration (excluding path, onDone, onCancel).
-     * @returns Promise that resolves with the edited image path, or rejects if cancelled.
+     * @param path    - Local file path of the image to edit.
+     * @param options - Optional editor configuration (excludes path, onDone, onCancel).
      */
     static edit(path: string, options?: Omit<ImageEditorConfig, 'path' | 'onDone' | 'onCancel'>): Promise<string>;
     /**
-     * @deprecated Use `ImageEditor.open()` instead. This method is kept for backward compatibility.
+     * @deprecated Use `ImageEditor.open()` instead.
      */
     static Edit(config: ImageEditorConfig): void;
 }
 /**
- * @deprecated Use `ImageEditor` instead. `PhotoEditor` is an alias kept for backward compatibility.
+ * @deprecated Use `ImageEditor` instead.
  */
 declare const PhotoEditor: typeof ImageEditor;
 export { ImageEditor, PhotoEditor };

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,kCAAkC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,oCAAoC;IACpC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kCAAkC;IAClC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kDAAkD;IAClD,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,yBAAyB,CAAC,EAAE,MAAM,CAAC;IACnC,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,OAAO,GACP,MAAM,GACN,MAAM,GACN,OAAO,GACP,SAAS,GACT,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IAEpB;;;OAGG;IACH,cAAc,CAAC,EAAE,aAAa,EAAE,CAAC;IAEjC;;;OAGG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC;;;;OAIG;IACH,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAErC;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;CACvB;AAyED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,cAAM,WAAW;IACf;;;;OAIG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAI5C;;;;;;;;OAQG;IACH,MAAM,CAAC,IAAI,CACT,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,IAAI,CAAC,iBAAiB,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC,GAChE,OAAO,CAAC,MAAM,CAAC;IAIlB;;OAEG;IACH,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;CAG7C;AAID;;GAEG;AACH,QAAA,MAAM,WAAW,oBAAc,CAAC;AAEhC,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AACpC,eAAe,WAAW,CAAC;AAE3B,mDAAmD;AACnD,MAAM,MAAM,gBAAgB,GAAG,iBAAiB,CAAC;AACjD,qDAAqD;AACrD,MAAM,MAAM,QAAQ,GAAG,mBAAmB,CAAC"}

package/package.json

@@ -1,37 +1,45 @@
 {
   "name": "@phucprime/react-native-image-editor",
-  "version": "1.0.2",
+  "version": "1.0.4",
   "description": "React Native: Native Image Editor for iOS and Android with drawing, text, stickers, cropping and more",
-  "main": "lib/index.js",
-  "types": "lib/index.d.ts",
-  "react-native": "src/index",
+  "main": "lib/commonjs/index.js",
+  "module": "lib/module/index.js",
+  "types": "lib/typescript/index.d.ts",
+  "react-native": "src/index.ts",
   "source": "src/index.ts",
   "files": [
-    "src/",
-    "lib/",
-    "ios/",
-    "android/",
-    "react-native-image-editor.podspec",
-    "!android/build/",
-    "!ios/build/",
-    "!**/__tests__/"
+    "src",
+    "lib",
+    "android/build.gradle",
+    "android/gradle",
+    "android/gradlew",
+    "android/gradlew.bat",
+    "android/libs/photo-editor-android.jar",
+    "android/src",
+    "ios",
+    "cpp",
+    "app.plugin.js",
+    "*.podspec",
+    "LICENSE",
+    "README.md"
   ],
-  "homepage": "https://github.com/phucprime/react-native-image-editor#readme",
+  "homepage": "https://github.com/nguyenhoangphucvnm/react-native-image-editor#readme",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/phucprime/react-native-image-editor.git"
+    "url": "git+https://github.com/nguyenhoangphucvnm/react-native-image-editor.git"
   },
   "bugs": {
-    "url": "https://github.com/phucprime/react-native-image-editor/issues"
+    "url": "https://github.com/nguyenhoangphucvnm/react-native-image-editor/issues"
   },
   "scripts": {
-    "build": "tsc --project tsconfig.build.json",
+    "build": "bob build",
     "typecheck": "tsc --noEmit",
     "lint": "prettier --check src/",
     "format": "prettier --write src/",
     "clean": "rm -rf lib/",
     "prepare": "npm run clean && npm run build",
-    "release": "npm run prepare && npm publish --access public --registry https://registry.npmjs.org/"
+    "release": "npm run prepare && npm publish --access public --registry https://registry.npmjs.org/",
+    "release:github": "dotenv -- npm publish"
   },
   "keywords": [
     "react-native",
@@ -57,6 +65,20 @@
       "javaPackageName": "ui.photoeditor"
     }
   },
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      "commonjs",
+      "module",
+      [
+        "typescript",
+        {
+          "project": "tsconfig.json"
+        }
+      ]
+    ]
+  },
   "peerDependencies": {
     "react": ">=18.2.0",
     "react-native": ">=0.73.0"
@@ -70,12 +92,21 @@
     }
   },
   "devDependencies": {
-    "@types/react": "^18.2.0 || ^19.0.0",
-    "prettier": "^3.2.0",
+    "@types/react": "18.2.0 || 19.0.0",
+    "dotenv-cli": "11.0.0",
+    "prettier": "3.2.0",
+    "react": "19.0.0",
     "react-native": "0.78.2",
-    "typescript": "^5.3.0"
+    "react-native-builder-bob": "0.43.1",
+    "typescript": "5.9.3"
   },
   "engines": {
     "node": ">=16.0.0"
-  }
-}
+  },
+  "publishConfig": {
+    "registry": "https://npm.pkg.github.com"
+  },
+  "workspaces": [
+    "Example"
+  ]
+}

package/react-native-image-editor.podspec

@@ -15,6 +15,14 @@ Pod::Spec.new do |s|
   s.source_files = "ios/**/*.{h,m,mm,swift}"
   s.dependency "iOSPhotoEditor"
 
+  # Always enforce C++17 so that C++ standard-library headers (<utility>, <vector>,
+  # <chrono>, …) resolve correctly when the pod is compiled alongside React Native's
+  # C++ TurboModule/JSI headers, regardless of architecture or RN version.
+  s.pod_target_xcconfig = {
+    "CLANG_CXX_LANGUAGE_STANDARD" => "c++17",
+    "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
+  }
+
   # Use install_modules_dependencies helper to install the dependencies if React Native version >=0.71.0.
   if respond_to?(:install_modules_dependencies, true)
     install_modules_dependencies(s)
@@ -24,11 +32,6 @@ Pod::Spec.new do |s|
     # Don't install the dependencies when we run `pod install` in the old architecture.
     if ENV["RCT_NEW_ARCH_ENABLED"] == "1"
       s.compiler_flags = folly_compiler_flags + " -DRCT_NEW_ARCH_ENABLED=1"
-      s.pod_target_xcconfig = {
-        "HEADER_SEARCH_PATHS" => "\"$(PODS_ROOT)/boost\"",
-        "OTHER_CPLUSPLUSFLAGS" => "-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1",
-        "CLANG_CXX_LANGUAGE_STANDARD" => "c++17",
-      }
       s.dependency "React-Codegen"
       s.dependency "RCT-Folly"
       s.dependency "RCTRequired"

package/src/NativeRNPhotoEditor.ts

@@ -1,19 +1,49 @@
 import type { TurboModule } from 'react-native';
 import { TurboModuleRegistry } from 'react-native';
 
+/**
+ * `UnsafeObject` is the codegen-recognised passthrough type for an untyped JS
+ * object parameter.  The React Native codegen AST parser matches on the name
+ * "UnsafeObject" in the source and maps it to NSDictionary* (iOS) /
+ * ReadableMap (Android).
+ *
+ * It must be declared as an empty object type `{}` — NOT as `Record<string, any>`,
+ * which the codegen parser rejects with "Unrecognised generic type 'Record'".
+ * The tsc compiler accepts `{}` fine for this purpose.
+ */
+// eslint-disable-next-line @typescript-eslint/ban-types
+type UnsafeObject = {};
+
 /**
  * TurboModule codegen spec for RNPhotoEditor.
  *
- * This spec enables proper New Architecture (Fabric + TurboModules) support
- * with compile-time type validation. On Old Architecture, TurboModuleRegistry
- * falls back to the NativeModules bridge automatically.
+ * Design notes
+ * ────────────
+ * • `props` is typed as `UnsafeObject` — the correct codegen-recognised alias
+ *   for an untyped JS object. Using plain `Object` is rejected by the strict
+ *   codegen validator in React Native 0.74+.
+ *
+ * • The method returns `Promise<string>` instead of accepting two `Callback`
+ *   parameters. `Callback` parameters are unsafe on New Architecture because
+ *   they are backed by a `CallbackHolder` tied to the current JS context; if
+ *   the JS context reloads while the native Activity / ViewController is open
+ *   (Fast Refresh, error boundary recovery) the stored block/lambda becomes
+ *   dangling. A `Promise` is resolved or rejected by the native side exactly
+ *   once and is safe across context reloads.
+ *
+ * • On Old Architecture `TurboModuleRegistry.getEnforcing` falls through to
+ *   the `NativeModules` bridge automatically (RN ≥ 0.73), so no separate
+ *   bridge registration is needed.
  */
 export interface Spec extends TurboModule {
-  Edit(
-    props: Object,
-    onDone: (result: string) => void,
-    onCancel: (result: number) => void,
-  ): void;
+  /**
+   * Open the native photo editor.
+   *
+   * @param props - Editor configuration object (path, colors, stickers, …).
+   * @returns Promise that resolves with the saved image path, or rejects with
+   *          code "CANCELLED" when the user dismisses without saving.
+   */
+  edit(props: UnsafeObject): Promise<string>;
 }
 
 export default TurboModuleRegistry.getEnforcing<Spec>('RNPhotoEditor');