Release 3.2.0

Author: pspdfkit-ci

CHANGELOG.md

@@ -1,6 +1,16 @@
+## 3.2.0 - 20 Oct 2025
+
+- Adds the page size to the existing `getPageInfo` API call. (J#HYB-888)
+- Adds the `androidEnableStylusOnDetection` option to the `PDFConfiguration` object to control stylus detection on Android. (J#HYB-893)
+- Updates related to Nutrient Android SDK 10.7.0.
+- Updates related to Nutrient iOS SDK 26.1.0.
+- Fixes image annotations being incorrectly placed when added on pages with a rotation or crop box. (J#IOS-767)
+- Fixes an issue where the `presentInstant` API call would never resolve its promise on iOS. (J#HYB-894)
+- Fixes an issue where the `onDocumentLoadFailed` callback wasn`t triggered for invalid documents on iOS. (J#HYB-885)
+
 ## 3.1.1 - 19 Sep 2025
 
-- Fixes an issue where the `setLicenseKey` API does not run synchronously on Android. (J#HYB-881)
+- Fixes an issue where the `setLicenseKey` API didn’t run synchronously on Android. (J#HYB-881)
 - Fixes an issue where the `FormFieldEvent.VALUES_UPDATED` event returned incomplete objects. (J#HYB-884)
 
 ## 3.1.0 - 10 Sep 2025
@@ -99,11 +109,11 @@ _[Migration guide](https://www.nutrient.io/guides/react-native/migration-guides/
 - Updates to Nutrient iOS SDK 14.5.0.
 - Updates Android `minSdkVersion` to API 24.
 - Updates the iOS deployment target to iOS 16. (#46035)
-- Fixes an issue where the `pageMargins` property used by the PDF generation API wasn't being used by Android. (J#HYB-555)
+- Fixes an issue where the `pageMargins` property used by the PDF generation API wasn’t being used by Android. (J#HYB-555)
 - Fixes an issue where the `documentPageChanged` event fired while the page change was still in progress on iOS. (J#HYB-644)
 - Fixes an issue where the `getConfiguration` API on Android returned inaccurate results. (J#HYB-648)
-- Removes the measurements `point` unit, as it isn't supported anymore. (#46035)
-- Removes the `iOSAllowedMenuAction` configuration property, as it isn't supported anymore. (#46035)
+- Removes the measurements `point` unit, as it isn’t supported anymore. (#46035)
+- Removes the `iOSAllowedMenuAction` configuration property, as it isn’t supported anymore. (#46035)
 
 ## 2.15.0 - 13 Dec 2024
 
@@ -119,7 +129,7 @@ _[Migration guide](https://www.nutrient.io/guides/react-native/migration-guides/
 - Adds the ability to hide the main toolbar on Android using a combination of configuration and style properties. (J#HYB-431)
 - Updates to Nutrient Android SDK 2024.6.1.
 - Updates to Nutrient iOS SDK 14.1.1.
-- Fixes an issue where the correct items weren't rendered when using the `menuItemGrouping` configuration property. (J#HYB-432)
+- Fixes an issue where the correct items weren’t rendered when using the `menuItemGrouping` configuration property. (J#HYB-432)
 - Fixes an issue where a crash occurred when using the `toolbar.toolbarMenuItems` property and `enterAnnotationCreationMode` API on Android. (J#HYB-517)
 - Fixes an issue where some annotations would not be deleted on iOS when using the `removeAnnotations` API. (J#HYB-518)
 
@@ -130,9 +140,9 @@ _[Migration guide](https://www.nutrient.io/guides/react-native/migration-guides/
 - Adds support to select and deselect annotations programmatically. (J#HYB-447)
 - Updates to PSPDFKit 2024.5.1 for Android.
 - Updates to PSPDFKit 13.9.1 for iOS.
-- Fixes an issue where certain annotation presets weren't applied correctly. (J#HYB-395)
+- Fixes an issue where certain annotation presets weren’t applied correctly. (J#HYB-395)
 - Fixes an issue where custom toolbar buttons were not applied on the Android toolbar. (J#HYB-482)
-- Fixes an issue where the `annotationTypes` parameter wasn't honored by the `processAnnotations` API. (J#HYB-495)
+- Fixes an issue where the `annotationTypes` parameter wasn’t honored by the `processAnnotations` API. (J#HYB-495)
 - Fixes an issue where the `onDocumentLoadFailed` callback was not triggered when an incorrect document password was specified on Android. (J#HYB-491)
 - Fixes an issue where some measurement annotation presets were not applied when specified. (J#HYB-492)
 
@@ -153,8 +163,8 @@ _[Migration guide](https://www.nutrient.io/guides/react-native/migration-guides/
 - Adds support for opening PDF documents from a remote URL. (J#HYB-354)
 - Updates `setAnnotationFlags` and `getAnnotationFlags` APIs to support using annotation `name` as an identifier. (J#HYB-372)
 - Fixes an issue where calling `exitCurrentlyActiveMode` while not in annotation editing mode generates an exception on iOS. (J#HYB-373)
-- Fixes an issue where the annotation `uuid` isn't included in `onAnnotationTapped` callbacks. (J#HYB-374)
-- Fixes an issue where Instant configuration wasn't applied when using the `presentInstant` API on iOS. (J#HYB-375)
+- Fixes an issue where the annotation `uuid` isn’t included in `onAnnotationTapped` callbacks. (J#HYB-374)
+- Fixes an issue where Instant configuration wasn’t applied when using the `presentInstant` API on iOS. (J#HYB-375)
 
 ## 2.10.0 - 06 May 2024
 

android/build.gradle

@@ -15,7 +15,7 @@
  *   Contains gradle configuration constants
  */
 ext {
-    NUTRIENT_VERSION = '10.5.0'
+    NUTRIENT_VERSION = '10.7.0'
 }
 
 buildscript {

android/src/main/java/com/pspdfkit/react/ConfigurationAdapter.java

@@ -95,6 +95,7 @@ public class ConfigurationAdapter {
     private static final String SHOW_SETTINGS_MENU = "showSettingsMenu";
     private static final String SHOW_DEFAULT_TOOLBAR = "showDefaultToolbar";
     private static final String SHOW_ACTION_BUTTONS = "showActionButtons";
+    private static final String ENABLE_STYLUS_ON_DETECTION = "enableStylusOnDetection";
 
     // Thumbnail Options
     private static final String SHOW_THUMBNAIL_BAR = "showThumbnailBar";
@@ -163,6 +164,7 @@ public ConfigurationAdapter(@NonNull final Context context, ReadableMap configur
         boolean hasConfiguration = iterator.hasNextKey();
         this.configuration = new PdfActivityConfiguration.Builder(context);
         this.configuration.contentEditingEnabled(false);
+        this.configuration.immersiveModeEnabled(false);
         if (hasConfiguration) {
             String key;
 
@@ -334,6 +336,10 @@ public ConfigurationAdapter(@NonNull final Context context, ReadableMap configur
             if (key != null) {
                 configureShowActionButtons(configuration.getBoolean(key));
             }
+            key = getKeyOrNull(configuration, ENABLE_STYLUS_ON_DETECTION);
+            if (key != null) {
+                configureEnableStylusOnDetection(configuration.getBoolean(key));
+            }
         }
     }
 
@@ -496,7 +502,7 @@ private void configureSignatureSavingStrategy(@Nullable final String signatureSa
     }
 
     private void configureImmersiveMode(final boolean immersiveMode) {
-        configuration.useImmersiveMode(immersiveMode);
+        configuration.immersiveModeEnabled(immersiveMode);
     }
 
     private void configureShowThumbnailBar(@Nullable final String showThumbnailBar) {
@@ -673,6 +679,10 @@ private void configureShowActionButtons(final boolean showActionButtons) {
         configuration.navigationButtonsEnabled(showActionButtons);
     }
 
+    private void configureEnableStylusOnDetection(final boolean enableStylus) {
+        configuration.stylusOnDetectionEnabled(enableStylus);
+    }
+
     public PdfActivityConfiguration build() {
         return configuration.build();
     }

android/src/main/java/com/pspdfkit/react/PDFDocumentModule.kt

@@ -91,10 +91,17 @@ class PDFDocumentModule(reactContext: ReactApplicationContext) : ReactContextBas
     @ReactMethod fun getPageInfo(reference: Int, pageIndex: Int, promise: Promise) {
         try {
             val rotation = this.getDocument(reference)?.document?.getPageRotation(pageIndex);
+            val size = this.getDocument(reference)?.document?.getPageSize(pageIndex);
             val result = Arguments.createMap()
             if (rotation != null) {
                 result.putInt("savedRotation", rotation)
             }
+            if (size != null) {
+                val sizeMap = Arguments.createMap()
+                sizeMap.putDouble("height", size.height.toDouble())
+                sizeMap.putDouble("width", size.width.toDouble())
+                result.putMap("size", sizeMap)
+            }
             promise.resolve(result);
         } catch (e: Throwable) {
             promise.reject("getPageInfo error", e)

android/src/main/java/com/pspdfkit/react/RNInstantPdfActivity.java

@@ -32,12 +32,10 @@ public void onSyncError(@NonNull InstantPdfDocument instantDocument, @NonNull In
     @Override
     public void onSyncFinished(@NonNull InstantPdfDocument instantDocument) {
         super.onSyncFinished(instantDocument);
-        Log.d("RNInstant::::::", "onSyncFinished: ");
     }
 
     @Override
     public void onSyncStarted(@NonNull InstantPdfDocument instantDocument) {
         super.onSyncStarted(instantDocument);
-        Log.d("RNInstant::::::", "onSyncStarted: ");
     }
 }

android/src/main/java/com/pspdfkit/react/SessionStorage.kt

@@ -0,0 +1,18 @@
+package com.pspdfkit.react
+
+import io.nutrient.domain.ai.AiAssistant
+
+object SessionStorage {
+    @Volatile
+    private var aiAssistant: AiAssistant? = null
+
+    @JvmStatic
+    fun getAiAssistant(): AiAssistant? = aiAssistant
+
+    @JvmStatic
+    fun setAiAssistant(assistant: AiAssistant?) {
+        aiAssistant = assistant
+    }
+}
+
+

android/src/main/java/com/pspdfkit/views/PdfView.java

@@ -48,10 +48,12 @@
 import com.facebook.react.uimanager.events.EventDispatcher;
 import com.pspdfkit.LicenseFeature;
 import com.pspdfkit.PSPDFKit;
+import com.pspdfkit.ai.AiAssistantHelpersKt;
 import com.pspdfkit.annotations.Annotation;
 import com.pspdfkit.annotations.AnnotationFlags;
 import com.pspdfkit.annotations.AnnotationType;
 import com.pspdfkit.annotations.configuration.FreeTextAnnotationConfiguration;
+import com.pspdfkit.configuration.PdfConfiguration;
 import com.pspdfkit.configuration.activity.PdfActivityConfiguration;
 import com.pspdfkit.configuration.search.SearchType;
 import com.pspdfkit.configuration.sharing.ShareFeatures;
@@ -126,6 +128,7 @@
 import java.util.concurrent.atomic.AtomicBoolean;
 
 import io.nutrient.data.models.AiAssistantConfiguration;
+import io.nutrient.data.models.DocumentIdentifiers;
 import io.nutrient.domain.ai.AiAssistant;
 import io.nutrient.domain.ai.AiAssistantKt;
 import io.reactivex.rxjava3.android.schedulers.AndroidSchedulers;
@@ -141,6 +144,7 @@
 import io.reactivex.rxjava3.schedulers.Schedulers;
 import io.reactivex.rxjava3.subjects.BehaviorSubject;
 import kotlin.Unit;
+import com.pspdfkit.react.SessionStorage;
 
 /**
  * This view displays a {@link com.pspdfkit.ui.PdfFragment} and all associated toolbars.
@@ -257,8 +261,10 @@ public void doFrame(long frameTimeNanos) {
             }
         });
 
-        // Set a default configuration.
-        configuration = new PdfActivityConfiguration.Builder(getContext()).build();
+        // Set a default configuration. Immersive should be disabled for React Native.
+        configuration = new PdfActivityConfiguration.Builder(getContext())
+                .immersiveModeEnabled(false)
+                .build();
 
         // Generate an id to set on all fragments created by the PdfView.
         internalId = View.generateViewId();
@@ -648,8 +654,16 @@ private void postFragmentSetup(PdfUiFragment pdfFragment) {
                             aiaConfiguration.getString("jwt"),
                             aiaConfiguration.getString("sessionID"),
                             aiaConfiguration.getString("userID"));
-                    AiAssistant aiAssistant = AiAssistantKt.standaloneAiAssistant(reactApplicationContext, aiaConfig);
-                    Objects.requireNonNull(pdfFragment.getDocument()).setAiAssistant(aiAssistant);
+
+                    PdfDocument document = fragment.getDocument();
+                    DocumentIdentifiers documentIdentifiers = new DocumentIdentifiers(document.getDocumentSource().getDataProvider(),
+                            document.getPermanentId().toString(),
+                            null,
+                            document.getPermanentId().toString(),
+                            null);
+
+                    AiAssistant aiAssistant = AiAssistantKt.standaloneAiAssistant(reactApplicationContext, aiaConfig, List.of(documentIdentifiers));
+                    SessionStorage.setAiAssistant(aiAssistant);
                 }
             } catch (Exception e) {
                 Log.w(TAG, "Failed to set AIA Configuration: " + e.getMessage());
@@ -1311,7 +1325,7 @@ public JSONObject convertConfiguration() {
 
             config.put("userInterfaceViewMode", ConfigurationAdapter.getStringValueForConfigurationItem(fragment.getConfiguration().getUserInterfaceViewMode()));
             config.put("inlineSearch", fragment.getConfiguration().getSearchType() == SearchType.INLINE ? true : false);
-            config.put("immersiveMode", fragment.getConfiguration().isImmersiveMode());
+            config.put("immersiveMode", fragment.getConfiguration().isImmersiveModeEnabled());
             config.put("toolbarTitle", fragment.getConfiguration().getActivityTitle());
             config.put("androidShowSearchAction", fragment.getConfiguration().isSearchEnabled());
             config.put("androidShowOutlineAction", fragment.getConfiguration().isOutlineEnabled());
@@ -1320,6 +1334,7 @@ public JSONObject convertConfiguration() {
             config.put("androidShowPrintAction", fragment.getConfiguration().isPrintingEnabled());
             config.put("androidShowDocumentInfoView", fragment.getConfiguration().isDocumentInfoViewEnabled());
             config.put("androidShowSettingsMenu", fragment.getConfiguration().isSettingsItemEnabled());
+            config.put("androidEnableStylusOnDetection", fragment.getConfiguration().getConfiguration().getEnableStylusOnDetection());
 
             config.put("showThumbnailBar", ConfigurationAdapter.getStringValueForConfigurationItem(fragment.getConfiguration().getThumbnailBarMode()));
             config.put("androidShowThumbnailGridAction", fragment.getConfiguration().isThumbnailGridEnabled());

ios/RCTPSPDFKit/Converters/RCTConvert+PSPDFAnnotation.m

@@ -72,7 +72,7 @@ + (NSDictionary *)formElementToJSON:(PSPDFFormElement *)formElement {
         mutableJSON[@"type"] = @"textField";
         formElementJSON = [mutableJSON copy];
     } else {
-        return nil; // Return nil if no conditions match
+        formElementJSON = nil;
     }
 
     return formElementJSON;

ios/RCTPSPDFKit/Helpers/SessionStorage.swift

@@ -16,6 +16,7 @@ import Foundation
 
     @objc public enum CallbackType: Int {
         case onDocumentLoaded
+        case onDocumentLoadFailed
         case onReady
     }
 

ios/RCTPSPDFKit/NutrientNotificationCenter.swift

@@ -203,13 +203,14 @@ import PSPDFKit
                     if (annotation is FormElement) {
                         guard let eventId = annotation.uuid as String? ,
                                       lastProcessedId != eventId else { return }
-                        if let annotationJSON = try? RCTConvert.instantJSON(from: (annotation as! FormElement)) {
+                        if let formElement = annotation as? FormElement,
+                           let annotationJSON = try? RCTConvert.instantJSON(from: formElement) {
                             let jsonData = ["event" : NotificationEvent.formFieldValuesUpdated.rawValue, "formField" : annotationJSON, "documentID" : documentID] as [String : Any]
                             let payload = createEventPayload(jsonData: jsonData, componentID: componentID)
                             eventEmitter?.sendEvent(withName:NotificationEvent.formFieldValuesUpdated.rawValue,
                                                     body: payload)
                         } else {
-                            // Could not decode annotation data
+                            // Could not decode annotation data or annotation was not a FormElement
                         }
                         lastProcessedId = eventId
                         // Clear the ID after 100ms