Release 4.1.0

Author: pspdfkit-ci

CHANGELOG.md

@@ -1,3 +1,14 @@
+## 4.1.0 — 30 Jan 2026
+
+- Adds the `updateAnnotations` API to `PDFDocument` to update existing annotation properties. (J#HYB-828)
+- Adds the `setUserInterfaceVisible` API to `NutrientView` to toggle the visibility of the user interface controls. (J#HYB-923)
+- Adds the `toolbarPosition` and `supportedToolbarPositions` options to the `PDFConfiguration` object to control the annotation toolbar position. (J#HYB-922)
+- Adds the `addTextFormField` and `addElectronicSignatureFormField` APIs to support programmatic form field creation. (J#HYB-924)
+- Updates the base `Annotation` model to expose the `group` property to control annotation grouping. (J#HYB-889)
+- Updates for Nutrient Android SDK 10.10.1.
+- Updates for Nutrient iOS SDK 26.4.0.
+- Fixes an issue where the `RemoteDocumentConfiguration` wasn’t being applied on iOS when opening a remote document. (J#HYB-939)
+
 ## 4.0.1 — 28 Nov 2025
 
 - Fixes an issue where the `setLicenseKeys` API could throw an error on iOS. (J#HYB-916)
@@ -6,6 +17,8 @@
 
 - Adds support for React Native’s new architecture. (J#HYB-847)
 - Updates the `onDocumentLoadFailed` and `DocumentEvent.LOAD_FAILED` events to include a reason code and message. (J#HYB-903)
+- Updates for Nutrient Android SDK 10.8.0.
+- Updates for Nutrient iOS SDK 26.2.0.
 
 ## 3.2.0 — 20 Oct 2025
 

LICENSE

@@ -1,4 +1,4 @@
-All items and source code Copyright © 2010-2025 PSPDFKit GmbH.
+All items and source code Copyright © 2010-2026 PSPDFKit GmbH.
 
 The Nutrient SDK is a commercial product and requires a license to be used.
 

README.md

@@ -51,7 +51,7 @@ Nutrient.setLicenseKey('YOUR_REACT_NATIVE_LICENSE_KEY_GOES_HERE');
 
 ### Installation
 
-The Nutrient React Native SDK dependency is installed from the GitHub repository and not the `npm` registry. To install the Nutrient React Native SDK, run `yarn add @nutrient-sdk/react-native` in your project directory or `npm install @nutrient-sdk/react-native` if you’re using `npm`.
+To install the Nutrient React Native SDK, run `yarn add @nutrient-sdk/react-native` in your project directory or `npm install @nutrient-sdk/react-native` if you’re using `npm`.
 
 ### Getting Started
 
@@ -244,7 +244,7 @@ Take a look at the instructions to get started [here](/samples/Catalog/README.md
 
 ### Configuration
 
-The behaviour of the `NutrientView` component can be customized using the configuration object. Refer to the [`PDFConfiguration`](https://www.nutrient.io/api/react-native/PDFConfiguration.html) API documentation. The `PDFConfiguration` object can be passed as parameter in when creating the `NutrientView` component, or when using the `Nutrient.present()` Native Module API.
+The behaviour of the `NutrientView` component can be customized using the configuration object. Refer to the [`PDFConfiguration`](https://www.nutrient.io/api/react-native/PDFConfiguration.html) API documentation. The `PDFConfiguration` object can be passed as a prop when creating the `NutrientView` component, or a parameter when using the `Nutrient.present()` Native Module API.
 
 ```typescript
 const configuration: PDFConfiguration = {
@@ -266,6 +266,6 @@ For Troubleshooting common issues you might encounter when setting up the Nutrie
 ## License
 
 This project can be used for evaluation or if you have a valid Nutrient license.
-All items and source code Copyright © 2010-2025 PSPDFKit GmbH.
+All items and source code Copyright © 2010-2026 PSPDFKit GmbH.
 
 See [LICENSE](./LICENSE) for details.

__tests__/pdfdocument.test.ts

@@ -8,10 +8,26 @@ jest.mock('react-native', () => {
 
 import { PDFDocument } from '../src/document/PDFDocument';
 import { NativeModules, findNodeHandle } from 'react-native';
+import {
+  ButtonFormElement,
+  ChoiceFormElement,
+  FormElement,
+  SignatureFormElement,
+  TextFieldFormElement,
+} from '../src/forms/FormElement';
+import {
+  ButtonFormField,
+  ChoiceFormField,
+  FormField,
+  SignatureFormField,
+  TextFormField,
+} from '../src/forms/FormField';
+import { WidgetAnnotation } from '../src/annotations/AnnotationModels';
 
 describe('PDFDocument JS helpers', () => {
   beforeEach(() => {
     jest.clearAllMocks();
+    (findNodeHandle as jest.Mock).mockReturnValue(999);
   });
 
   test('getRef returns numeric reference when findNodeHandle returns null (Fabric fallback)', () => {
@@ -27,6 +43,239 @@ describe('PDFDocument JS helpers', () => {
     (NativeModules.PDFDocumentManager.getPageCount as jest.Mock).mockResolvedValueOnce(3);
     await expect(doc.setPageIndex(10)).rejects.toBeInstanceOf(Error);
   });
+
+  describe('createAnnotationInstance - Widget annotations with form elements', () => {
+    let doc: PDFDocument;
+    const mockPdfViewRef = { current: {} };
+
+    beforeEach(() => {
+      doc = new PDFDocument(1234);
+      // @ts-ignore access private
+      doc.pdfViewRef = mockPdfViewRef;
+    });
+
+    test('creates ButtonFormElement and ButtonFormField for button formTypeName', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'button',
+          name: 'test-button',
+          formField: {
+            type: 'button',
+            name: 'test-button',
+            value: 'button-value',
+          },
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result).toBeInstanceOf(WidgetAnnotation);
+      expect(result.formElement).toBeInstanceOf(ButtonFormElement);
+      expect(result.formElement.formField).toBeInstanceOf(ButtonFormField);
+      expect(result.formElement.pdfViewRef).toBe(999);
+      expect(findNodeHandle).toHaveBeenCalledWith(mockPdfViewRef);
+    });
+
+    test('creates ChoiceFormElement and ChoiceFormField for choice formTypeName', () => {
+      const annotationData = {
+        type: 'widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'choice',
+          name: 'test-choice',
+          formField: {
+            type: 'choice',
+            name: 'test-choice',
+            value: 'choice-value',
+          },
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result).toBeInstanceOf(WidgetAnnotation);
+      expect(result.formElement).toBeInstanceOf(ChoiceFormElement);
+      expect(result.formElement.formField).toBeInstanceOf(ChoiceFormField);
+      expect(result.formElement.pdfViewRef).toBe(999);
+    });
+
+    test('creates SignatureFormElement and SignatureFormField for signature formTypeName', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'signature',
+          name: 'test-signature',
+          formField: {
+            type: 'signature',
+            name: 'test-signature',
+            value: 'signature-value',
+          },
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result).toBeInstanceOf(WidgetAnnotation);
+      expect(result.formElement).toBeInstanceOf(SignatureFormElement);
+      expect(result.formElement.formField).toBeInstanceOf(SignatureFormField);
+      expect(result.formElement.pdfViewRef).toBe(999);
+    });
+
+    test('creates TextFieldFormElement and TextFormField for textfield formTypeName', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'textField',
+          name: 'test-textfield',
+          formField: {
+            type: 'text',
+            name: 'test-textfield',
+            value: 'text-value',
+          },
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result).toBeInstanceOf(WidgetAnnotation);
+      expect(result.formElement).toBeInstanceOf(TextFieldFormElement);
+      expect(result.formElement.formField).toBeInstanceOf(TextFormField);
+      expect(result.formElement.pdfViewRef).toBe(999);
+    });
+
+    test('creates FormElement and FormField for unknown formTypeName', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'unknown-type',
+          name: 'test-unknown',
+          formField: {
+            type: 'unknown',
+            name: 'test-unknown',
+            value: 'unknown-value',
+          },
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result).toBeInstanceOf(WidgetAnnotation);
+      expect(result.formElement).toBeInstanceOf(FormElement);
+      expect(result.formElement.formField).toBeInstanceOf(FormField);
+      expect(result.formElement.pdfViewRef).toBe(999);
+    });
+
+    test('handles formTypeName case insensitivity', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'BUTTON', // uppercase
+          name: 'test-button',
+          formField: {
+            type: 'button',
+            name: 'test-button',
+          },
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result.formElement).toBeInstanceOf(ButtonFormElement);
+    });
+
+    test('handles widget annotation without formElement', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result).toBeInstanceOf(WidgetAnnotation);
+      expect(result.formElement).toBeUndefined();
+    });
+
+    test('handles formElement without formField', () => {
+      const annotationData = {
+        type: 'pspdfkit/widget',
+        pageIndex: 0,
+        bbox: [0, 0, 100, 50],
+        horizontalAlign: 'left',
+        verticalAlign: 'top',
+        formElement: {
+          formTypeName: 'button',
+          name: 'test-button',
+        },
+      };
+
+      // @ts-ignore access private
+      const result = doc.createAnnotationInstance(annotationData);
+
+      expect(result.formElement).toBeInstanceOf(ButtonFormElement);
+      expect(result.formElement.formField).toBeUndefined();
+    });
+
+    test('sets pdfViewRef on formElementInstance for all form types', () => {
+      const formTypes = ['button', 'choice', 'signature', 'textField', 'unknown'];
+      
+      formTypes.forEach((formType) => {
+        const annotationData = {
+          type: 'pspdfkit/widget',
+          pageIndex: 0,
+          bbox: [0, 0, 100, 50],
+          horizontalAlign: 'left',
+          verticalAlign: 'top',
+          formElement: {
+            formTypeName: formType,
+            name: `test-${formType}`,
+            formField: {
+              type: formType,
+              name: `test-${formType}`,
+            },
+          },
+        };
+
+        // @ts-ignore access private
+        const result = doc.createAnnotationInstance(annotationData);
+        
+        expect(result.formElement.pdfViewRef).toBe(999);
+      });
+    });
+  });
 });
 
 

android/build.gradle

@@ -3,7 +3,7 @@
  *
  *   Nutrient
  *
- *   Copyright © 2021-2025 PSPDFKit GmbH. All rights reserved.
+ *   Copyright © 2021-2026 PSPDFKit GmbH. All rights reserved.
  *
  *   THIS SOURCE CODE AND ANY ACCOMPANYING DOCUMENTATION ARE PROTECTED BY INTERNATIONAL COPYRIGHT LAW
  *   AND MAY NOT BE RESOLD OR REDISTRIBUTED. USAGE IS BOUND TO THE PSPDFKIT LICENSE AGREEMENT.
@@ -15,7 +15,7 @@
  *   Contains gradle configuration constants
  */
 ext {
-    NUTRIENT_VERSION = '10.8.0'
+    NUTRIENT_VERSION = '10.10.1'
 }
 
 buildscript {
@@ -25,7 +25,7 @@ buildscript {
 
     ext.getComposeVersion = { kotlin_version ->
         switch (kotlin_version) {
-            case ~/2\..*/: 
+            case ~/2\..*/:
                 // For Kotlin 2.x+, compose compiler is handled by the plugin
                 return null
             case '1.9.25': return '1.5.15'
@@ -122,26 +122,41 @@ android {
     }
 }
 
+configurations.all {
+    resolutionStrategy {
+        force "androidx.compose.foundation:foundation:1.9.4"
+        force "androidx.compose.ui:ui:1.9.4"
+        force "androidx.compose.runtime:runtime:1.9.4"
+        force "androidx.compose.material:material:1.9.4"
+        force "androidx.compose.material3:material3:1.4.0"
+    }
+}
+
 dependencies {
     api("io.nutrient:nutrient:${NUTRIENT_VERSION}") {
         exclude group: 'com.google.auto.value', module: 'auto-value'
         exclude group: 'androidx.recyclerview', module: 'recyclerview'
     }
 
     implementation "com.facebook.react:react-native:+"
+
+    // OkHttp dependencies
     implementation 'com.squareup.okhttp3:okhttp:4.9.2'
     implementation 'com.squareup.okhttp3:logging-interceptor:4.12.0'
-    implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-    implementation "androidx.compose.material:material:1.7.8"
-    implementation "androidx.compose.material3:material3:1.3.1"
-    implementation "androidx.recyclerview:recyclerview:1.3.2"
 
-    // AI Assistant
+    implementation "androidx.recyclerview:recyclerview:1.4.0"
+
+    // Explicitly declare Compose Foundation to ensure version 1.9.4 (matches PSPDFKit SDK)
+    implementation "androidx.compose.foundation:foundation:1.9.4"
+
+    // Let PSPDFKit SDK manage Compose versions - only specify lifecycle-viewmodel-compose to match SDK requirement
+    implementation "androidx.lifecycle:lifecycle-viewmodel-compose:2.9.4"
+
+    // AI Assistant dependencies
     implementation("io.noties.markwon:core:4.6.2")
     implementation("io.noties.markwon:html:4.6.2")
     implementation("io.noties.markwon:linkify:4.6.2")
     implementation("io.noties.markwon:ext-tables:4.6.2")
     implementation("io.noties.markwon:ext-strikethrough:4.6.2")
-    implementation("io.socket:socket.io-client:2.1.1")
-    implementation "androidx.lifecycle:lifecycle-viewmodel-compose:2.7.0"
+    implementation("io.socket:socket.io-client:2.1.2")
 }