@syncfusion/ej2-pdf 25.2.3 → 25.2.6

package/dist/global/index.d.ts

@@ -1,6 +1,6 @@
 /*!
 *  filename: index.d.ts
-*  version : 25.2.3
+*  version : 25.2.6
 *  Copyright Syncfusion Inc. 2001 - 2023. All rights reserved.
 *  Use of this code is subject to the terms of our license.
 *  A copy of the current license can be obtained at any time by e-mailing

package/package.json

@@ -1,8 +1,8 @@
 {
   "_from": "@syncfusion/ej2-pdf@*",
-  "_id": "@syncfusion/ej2-pdf@25.1.42",
+  "_id": "@syncfusion/ej2-pdf@25.2.3",
   "_inBundle": false,
-  "_integrity": "sha512-vqldWjmy3RjHr9lFc0s6OIA/usm/v9nfsEUtiJ57f74MsfDLPTKQRXGlOKkOKUj3ljrUkfn7JbjjW6K7OayEHA==",
+  "_integrity": "sha512-eHarTmqnGF5RV+CCdG4DTy72d4/1tOLOh2donMEWsOGWz62Vnpi+rl5/XxQr2aR3o0RvHy5XlzUBAOVugakq8g==",
   "_location": "/@syncfusion/ej2-pdf",
   "_phantomChildren": {},
   "_requested": {
@@ -21,8 +21,8 @@
     "/@syncfusion/ej2",
     "/@syncfusion/ej2-pdfviewer"
   ],
-  "_resolved": "https://nexus.syncfusioninternal.com/repository/ej2-hotfix-new/@syncfusion/ej2-pdf/-/ej2-pdf-25.1.42.tgz",
-  "_shasum": "3f06568c8e0bd79cdbcc53551c78de3dc406d5ba",
+  "_resolved": "https://nexus.syncfusioninternal.com/repository/ej2-hotfix-new/@syncfusion/ej2-pdf/-/ej2-pdf-25.2.3.tgz",
+  "_shasum": "599fa64750e27b0d9c14148571ad89cf8aef6f93",
   "_spec": "@syncfusion/ej2-pdf@*",
   "_where": "/jenkins/workspace/elease-automation_release_25.1.1/packages/included",
   "author": {
@@ -30,7 +30,7 @@
   },
   "bundleDependencies": false,
   "dependencies": {
-    "@syncfusion/ej2-base": "~25.2.3",
+    "@syncfusion/ej2-base": "~25.2.5",
     "@syncfusion/ej2-compression": "~25.2.3"
   },
   "deprecated": false,
@@ -55,7 +55,7 @@
     "url": "https://github.com/syncfusion/ej2-javascript-ui-controls/tree/master/controls/pdf"
   },
   "typings": "index.d.ts",
-  "version": "25.2.3",
+  "version": "25.2.6",
   "sideEffects": false,
   "homepage": "https://www.syncfusion.com/javascript-ui-controls"
 }

package/src/pdf/core/annotations/annotation.d.ts

@@ -4154,6 +4154,7 @@ export declare class PdfWidgetAnnotation extends PdfAnnotation {
     _fontName: string;
     _isFont: boolean;
     _isTransparentBackColor: boolean;
+    _isTransparentBorderColor: boolean;
     /**
      * Initializes a new instance of the `PdfWidgetAnnotation` class.
      *
@@ -4263,6 +4264,7 @@ export declare class PdfWidgetAnnotation extends PdfAnnotation {
     */
     backColor: number[];
     readonly _hasBackColor: boolean;
+    readonly _hasBorderColor: boolean;
     /**
      * Gets the border color of the annotation.
      *
@@ -4283,7 +4285,7 @@ export declare class PdfWidgetAnnotation extends PdfAnnotation {
     /**
     * Sets the border color of the annotation.
     *
-    * @param {number[]} value Color as R, G, B color array in between 0 to 255.
+    * @param {number[]} value Array with R, G, B, A color values in between 0 to 255.. For optional A (0-254), it signifies transparency.
     * ```typescript
     * // Load an existing PDF document
     * let document: PdfDocument = new PdfDocument(data, password);
@@ -4544,7 +4546,9 @@ export declare class PdfWidgetAnnotation extends PdfAnnotation {
     _getPage(): PdfPage;
     _beginSave(): void;
     _parseBackColor(): number[];
+    _parseBorderColor(): number[];
     _updateBackColor(value: number[], setAppearance?: boolean): void;
+    _updateBorderColor(value: number[], setAppearance?: boolean): void;
 }
 /**
  * `PdfStateItem` class represents the check box field item objects.

package/src/pdf/core/annotations/annotation.js

@@ -12010,6 +12010,7 @@ var PdfWidgetAnnotation = /** @class */ (function (_super) {
         _this._visibility = PdfFormFieldVisibility.visible;
         _this._isFont = false;
         _this._isTransparentBackColor = false;
+        _this._isTransparentBorderColor = false;
         _this._isWidget = true;
         _this._type = _PdfAnnotationType.widgetAnnotation;
         return _this;
@@ -12173,6 +12174,19 @@ var PdfWidgetAnnotation = /** @class */ (function (_super) {
         enumerable: true,
         configurable: true
     });
+    Object.defineProperty(PdfWidgetAnnotation.prototype, "_hasBorderColor", {
+        get: function () {
+            if (this._isLoaded) {
+                var mkDictionary = this._mkDictionary;
+                return (mkDictionary && mkDictionary.has('BC'));
+            }
+            else {
+                return !this._isTransparentBorderColor;
+            }
+        },
+        enumerable: true,
+        configurable: true
+    });
     Object.defineProperty(PdfWidgetAnnotation.prototype, "borderColor", {
         /**
          * Gets the border color of the annotation.
@@ -12192,24 +12206,12 @@ var PdfWidgetAnnotation = /** @class */ (function (_super) {
          * ```
          */
         get: function () {
-            if (typeof this._borderColor === 'undefined') {
-                var mkDict = this._mkDictionary;
-                if (mkDict && mkDict.has('BC')) {
-                    var bcArray = mkDict.getArray('BC');
-                    if (bcArray) {
-                        this._borderColor = _parseColor(bcArray);
-                    }
-                }
-            }
-            if (typeof this._borderColor === 'undefined' || this._borderColor === null) {
-                this._borderColor = [0, 0, 0];
-            }
-            return this._borderColor;
+            return this._parseBorderColor();
         },
         /**
          * Sets the border color of the annotation.
          *
-         * @param {number[]} value Color as R, G, B color array in between 0 to 255.
+         * @param {number[]} value Array with R, G, B, A color values in between 0 to 255.. For optional A (0-254), it signifies transparency.
          * ```typescript
          * // Load an existing PDF document
          * let document: PdfDocument = new PdfDocument(data, password);
@@ -12226,15 +12228,7 @@ var PdfWidgetAnnotation = /** @class */ (function (_super) {
          * ```
          */
         set: function (value) {
-            if (typeof this.borderColor === 'undefined' || this.borderColor !== value) {
-                if (typeof this._mkDictionary === 'undefined') {
-                    this._dictionary.update('MK', new _PdfDictionary(this._crossReference));
-                }
-                this._mkDictionary.update('BC', [Number.parseFloat((value[0] / 255).toFixed(3)),
-                    Number.parseFloat((value[1] / 255).toFixed(3)),
-                    Number.parseFloat((value[2] / 255).toFixed(3))]);
-                this._borderColor = value;
-            }
+            this._updateBorderColor(value, true);
         },
         enumerable: true,
         configurable: true
@@ -12868,6 +12862,25 @@ var PdfWidgetAnnotation = /** @class */ (function (_super) {
         }
         return value;
     };
+    PdfWidgetAnnotation.prototype._parseBorderColor = function () {
+        var value;
+        if ((this._isLoaded && this._hasBorderColor) || (!this._isLoaded && !this._isTransparentBorderColor)) {
+            if (typeof this._borderColor === 'undefined') {
+                var dictionary = this._mkDictionary;
+                if (dictionary && dictionary.has('BC')) {
+                    var colorArray = dictionary.getArray('BC');
+                    if (colorArray) {
+                        this._borderColor = _parseColor(colorArray);
+                    }
+                }
+            }
+            if (typeof this._borderColor === 'undefined' || this._borderColor === null) {
+                this._borderColor = [0, 0, 0];
+            }
+            value = this._borderColor;
+        }
+        return value;
+    };
     PdfWidgetAnnotation.prototype._updateBackColor = function (value, setAppearance) {
         if (setAppearance === void 0) { setAppearance = false; }
         var isChanged = false;
@@ -12902,6 +12915,39 @@ var PdfWidgetAnnotation = /** @class */ (function (_super) {
             this._field._setAppearance = true;
         }
     };
+    PdfWidgetAnnotation.prototype._updateBorderColor = function (value, setAppearance) {
+        if (setAppearance === void 0) { setAppearance = false; }
+        if (value.length === 4 && value[3] !== 255) {
+            this._isTransparentBorderColor = true;
+            if (this._dictionary.has('BC')) {
+                delete this._dictionary._map.BC;
+            }
+            var mkDictionary = this._mkDictionary;
+            if (mkDictionary && mkDictionary.has('BC')) {
+                delete mkDictionary._map.BC;
+                if (this._dictionary.has('BS')) {
+                    var bsDictionary = this._dictionary.get('BS');
+                    if (bsDictionary && bsDictionary.has('W')) {
+                        delete bsDictionary._map.W;
+                    }
+                }
+                this._dictionary._updated = true;
+            }
+        }
+        else {
+            this._isTransparentBorderColor = false;
+            if (typeof this.borderColor === 'undefined' || this.borderColor !== value) {
+                if (typeof this._mkDictionary === 'undefined') {
+                    this._dictionary.update('MK', new _PdfDictionary(this._crossReference));
+                }
+                this._mkDictionary.update('BC', [Number.parseFloat((value[0] / 255).toFixed(3)),
+                    Number.parseFloat((value[1] / 255).toFixed(3)),
+                    Number.parseFloat((value[2] / 255).toFixed(3))]);
+                this._borderColor = [value[0], value[1], value[2]];
+                this._dictionary._updated = true;
+            }
+        }
+    };
     return PdfWidgetAnnotation;
 }(PdfAnnotation));
 export { PdfWidgetAnnotation };

package/src/pdf/core/form/field.d.ts

@@ -53,6 +53,7 @@ export declare abstract class PdfField {
     _white: PdfBrush;
     _black: PdfBrush;
     _isTransparentBackColor: boolean;
+    _isTransparentBorderColor: boolean;
     _tabIndex: number;
     _annotationIndex: number;
     _defaultFont: PdfStandardFont;
@@ -405,7 +406,7 @@ export declare abstract class PdfField {
     /**
     * Sets the border color of the field.
     *
-    * @param {number[]} value R, G, B color values in between 0 to 255.
+    * @param {number[]} Value Array with R, G, B, A color values in between 0 to 255. For optional A (0-254), it signifies transparency.
     * ```typescript
     * // Load an existing PDF document
     * let document: PdfDocument = new PdfDocument(data, password);
@@ -706,8 +707,11 @@ export declare abstract class PdfField {
     readonly _blackBrush: PdfBrush;
     readonly _kidsCount: number;
     readonly _hasBackColor: boolean;
+    readonly _hasBorderColor: boolean;
     _parseBackColor(hasTransparency: boolean): number[];
+    _parseBorderColor(hasTransparency: boolean): number[];
     _updateBackColor(value: number[], hasTransparency?: boolean): void;
+    _updateBorderColor(value: number[], hasTransparency?: boolean): void;
     /**
      * Gets the field item as `PdfWidgetAnnotation` at the specified index.
      *
@@ -1952,6 +1956,41 @@ export declare class PdfCheckBoxField extends PdfField {
     * ```
     */
     backColor: number[];
+    /**
+     * Gets the border color of the field.
+     *
+     * @returns {number[]} R, G, B color values in between 0 to 255.
+     * ```typescript
+     * // Load an existing PDF document
+     * let document: PdfDocument = new PdfDocument(data, password);
+     * // Access the form field at index 0
+     * let field: PdfField = document.form.fieldAt(0);
+     * // Gets the border color of the field.
+     * let borderColor: number[] = field.borderColor;
+     * // Save the document
+     * document.save('output.pdf');
+     * // Destroy the document
+     * document.destroy();
+     * ```
+     */
+    /**
+    * Sets the border color of the field.
+    *
+    * @param {number[]} value Array with R, G, B, A color values in between 0 to 255. For optional A (0-254), it signifies transparency.
+    * ```typescript
+    * // Load an existing PDF document
+    * let document: PdfDocument = new PdfDocument(data, password);
+    * // Access the form field at index 0
+    * let field: PdfField = document.form.fieldAt(0);
+    * // Sets the border color of the field.
+    * field.borderColor = [255, 0, 0];
+    * // Save the document
+    * document.save('output.pdf');
+    * // Destroy the document
+    * document.destroy();
+    * ```
+    */
+    borderColor: number[];
     _initialize(page: PdfPage, name: string, bounds: {
         x: number;
         y: number;
@@ -2116,6 +2155,41 @@ export declare class PdfRadioButtonListField extends PdfField {
     * ```
     */
     selectedIndex: number;
+    /**
+     * Gets the border color of the field.
+     *
+     * @returns {number[]} R, G, B color values in between 0 to 255.
+     * ```typescript
+     * // Load an existing PDF document
+     * let document: PdfDocument = new PdfDocument(data, password);
+     * // Access the form field at index 0
+     * let field: PdfField = document.form.fieldAt(0);
+     * // Gets the border color of the field.
+     * let borderColor: number[] = field.borderColor;
+     * // Save the document
+     * document.save('output.pdf');
+     * // Destroy the document
+     * document.destroy();
+     * ```
+     */
+    /**
+    * Sets the border color of the field.
+    *
+    * @param {number[]} value Array with R, G, B, A color values in between 0 to 255. For optional A (0-254), it signifies transparency.
+    * ```typescript
+    * // Load an existing PDF document
+    * let document: PdfDocument = new PdfDocument(data, password);
+    * // Access the form field at index 0
+    * let field: PdfField = document.form.fieldAt(0);
+    * // Sets the border color of the field.
+    * field.borderColor = [255, 0, 0];
+    * // Save the document
+    * document.save('output.pdf');
+    * // Destroy the document
+    * document.destroy();
+    * ```
+    */
+    borderColor: number[];
     /**
      * Gets the item at the specified index.
      *