@syncfusion/ej2-pdf 25.2.3 → 25.2.6

package/dist/es6/ej2-pdf.es5.js

@@ -15450,6 +15450,7 @@ var PdfField = /** @__PURE__ @class */ (function () {
     function PdfField() {
         this._visible = true;
         this._isTransparentBackColor = false;
+        this._isTransparentBorderColor = false;
         this._defaultFont = new PdfStandardFont(PdfFontFamily.helvetica, 8);
         this._appearanceFont = new PdfStandardFont(PdfFontFamily.helvetica, 10, PdfFontStyle.regular);
         this._defaultItemFont = new PdfStandardFont(PdfFontFamily.timesRoman, 12);
@@ -16069,29 +16070,12 @@ var PdfField = /** @__PURE__ @class */ (function () {
          * ```
          */
         get: function () {
-            var value;
-            var widget = this.itemAt(this._defaultIndex);
-            if (widget && widget.borderColor) {
-                value = widget.borderColor;
-            }
-            else if (this._mkDictionary) {
-                var dictionary = this._mkDictionary;
-                if (dictionary && dictionary.has('BC')) {
-                    var colorArray = dictionary.getArray('BC');
-                    if (colorArray) {
-                        value = _parseColor(colorArray);
-                    }
-                }
-            }
-            if (typeof value === 'undefined' || value === null) {
-                value = [0, 0, 0];
-            }
-            return value;
+            return this._parseBorderColor(true);
         },
         /**
          * 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);
@@ -16106,26 +16090,7 @@ var PdfField = /** @__PURE__ @class */ (function () {
          * ```
          */
         set: function (value) {
-            var widget = this.itemAt(this._defaultIndex);
-            if (widget && widget.borderColor !== value) {
-                widget.borderColor = value;
-            }
-            else {
-                var mkDict = this._mkDictionary;
-                if (typeof mkDict === 'undefined') {
-                    var dictionary = new _PdfDictionary(this._crossReference);
-                    dictionary.update('BC', [Number.parseFloat((value[0] / 255).toFixed(3)),
-                        Number.parseFloat((value[1] / 255).toFixed(3)),
-                        Number.parseFloat((value[2] / 255).toFixed(3))]);
-                    this._dictionary.update('MK', dictionary);
-                }
-                else if (!mkDict.has('BC') || _parseColor(mkDict.getArray('BC')) !== value) {
-                    mkDict.update('BC', [Number.parseFloat((value[0] / 255).toFixed(3)),
-                        Number.parseFloat((value[1] / 255).toFixed(3)),
-                        Number.parseFloat((value[2] / 255).toFixed(3))]);
-                    this._dictionary._updated = true;
-                }
-            }
+            this._updateBorderColor(value, true);
         },
         enumerable: true,
         configurable: true
@@ -16721,6 +16686,25 @@ var PdfField = /** @__PURE__ @class */ (function () {
         enumerable: true,
         configurable: true
     });
+    Object.defineProperty(PdfField.prototype, "_hasBorderColor", {
+        get: function () {
+            if (this._isLoaded) {
+                var mkDictionary = this._mkDictionary;
+                if (!mkDictionary) {
+                    var item = this.itemAt(this._defaultIndex);
+                    if (item && item._dictionary.has('MK')) {
+                        mkDictionary = item._dictionary.get('MK');
+                    }
+                }
+                return (mkDictionary && mkDictionary.has('BC'));
+            }
+            else {
+                return !this._isTransparentBorderColor;
+            }
+        },
+        enumerable: true,
+        configurable: true
+    });
     PdfField.prototype._parseBackColor = function (hasTransparency) {
         var value;
         if ((!hasTransparency) || ((this._isLoaded && this._hasBackColor) || (!this._isLoaded && !this._isTransparentBackColor))) {
@@ -16743,6 +16727,28 @@ var PdfField = /** @__PURE__ @class */ (function () {
         }
         return value;
     };
+    PdfField.prototype._parseBorderColor = function (hasTransparency) {
+        var value;
+        if ((!hasTransparency) || ((this._isLoaded && this._hasBorderColor) || (!this._isLoaded && !this._isTransparentBorderColor))) {
+            var widget = this.itemAt(this._defaultIndex);
+            if (widget && widget.borderColor) {
+                value = widget.borderColor;
+            }
+            else if (this._mkDictionary) {
+                var mkDict = this._mkDictionary;
+                if (mkDict && mkDict.has('BC')) {
+                    var bgArray = mkDict.getArray('BC');
+                    if (bgArray) {
+                        value = _parseColor(bgArray);
+                    }
+                }
+            }
+            if (typeof value === 'undefined' || value === null) {
+                value = [0, 0, 0];
+            }
+        }
+        return value;
+    };
     PdfField.prototype._updateBackColor = function (value, hasTransparency) {
         if (hasTransparency === void 0) { hasTransparency = false; }
         if (hasTransparency && value.length === 4 && value[3] !== 255) {
@@ -16784,6 +16790,53 @@ var PdfField = /** @__PURE__ @class */ (function () {
             }
         }
     };
+    PdfField.prototype._updateBorderColor = function (value, hasTransparency) {
+        if (hasTransparency === void 0) { hasTransparency = false; }
+        if (hasTransparency && 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;
+            }
+            var item = this.itemAt(this._defaultIndex);
+            if (item) {
+                item.borderColor = value;
+            }
+        }
+        else {
+            this._isTransparentBorderColor = false;
+            var widget = this.itemAt(this._defaultIndex);
+            if (widget && widget.borderColor !== value) {
+                widget.borderColor = value;
+            }
+            else {
+                var mkDictionary = this._mkDictionary;
+                if (typeof mkDictionary === 'undefined') {
+                    var dictionary = new _PdfDictionary(this._crossReference);
+                    dictionary.update('BC', [Number.parseFloat((value[0] / 255).toFixed(3)),
+                        Number.parseFloat((value[1] / 255).toFixed(3)),
+                        Number.parseFloat((value[2] / 255).toFixed(3))]);
+                    this._dictionary.update('MK', dictionary);
+                }
+                else if (!mkDictionary.has('BC') || _parseColor(mkDictionary.getArray('BC')) !== value) {
+                    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._dictionary._updated = true;
+                }
+            }
+        }
+    };
     /**
      * Gets the field item as `PdfWidgetAnnotation` at the specified index.
      *
@@ -17255,19 +17308,19 @@ var PdfField = /** @__PURE__ @class */ (function () {
         switch (state) {
             case _PdfCheckFieldState.unchecked:
             case _PdfCheckFieldState.checked:
-                if (parameter.borderPen) {
+                if (parameter.borderPen || parameter.backBrush) {
                     graphics.drawRectangle(parameter.bounds[0], parameter.bounds[1], parameter.bounds[2], parameter.bounds[3], parameter.backBrush);
                 }
                 break;
             case _PdfCheckFieldState.pressedChecked:
             case _PdfCheckFieldState.pressedUnchecked:
-                if ((parameter.borderStyle === PdfBorderStyle.beveled) ||
+                if ((parameter.borderStyle === PdfBorderStyle.beveled || parameter.backBrush) ||
                     (parameter.borderStyle === PdfBorderStyle.underline)) {
-                    if (parameter.borderPen) {
+                    if (parameter.borderPen || parameter.backBrush) {
                         graphics.drawRectangle(parameter.bounds[0], parameter.bounds[1], parameter.bounds[2], parameter.bounds[3], parameter.backBrush);
                     }
                 }
-                else if (parameter.borderPen) {
+                else if (parameter.borderPen || parameter.shadowBrush) {
                     graphics.drawRectangle(parameter.bounds[0], parameter.bounds[1], parameter.bounds[2], parameter.bounds[3], parameter.shadowBrush);
                 }
                 break;
@@ -18427,7 +18480,9 @@ var PdfTextBoxField = /** @__PURE__ @class */ (function (_super) {
         }
         parameter.foreBrush = new PdfBrush(widget.color);
         var border = widget.border;
-        parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        if (widget.borderColor) {
+            parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        }
         parameter.borderStyle = border.style;
         parameter.borderWidth = border.width;
         if (backcolor) {
@@ -18476,7 +18531,7 @@ var PdfTextBoxField = /** @__PURE__ @class */ (function (_super) {
         if (typeof maxLength !== 'undefined') {
             if (parameter.insertSpaces) {
                 var width = 0;
-                if (typeof maxLength !== 'undefined' && maxLength > 0) {
+                if (typeof maxLength !== 'undefined' && maxLength > 0 && this.borderColor) {
                     width = parameter.bounds[2] / maxLength;
                     g.drawRectangle(parameter.bounds[0], parameter.bounds[1], parameter.bounds[2], parameter.bounds[3], parameter.borderPen, parameter.backBrush);
                     var current = text;
@@ -19157,7 +19212,9 @@ var PdfButtonField = /** @__PURE__ @class */ (function (_super) {
         }
         parameter.foreBrush = new PdfBrush(widget.color);
         var border = widget.border;
-        parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        if (widget.borderColor) {
+            parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        }
         parameter.borderStyle = border.style;
         parameter.borderWidth = border.width;
         if (backcolor) {
@@ -19627,6 +19684,53 @@ var PdfCheckBoxField = /** @__PURE__ @class */ (function (_super) {
         enumerable: true,
         configurable: true
     });
+    Object.defineProperty(PdfCheckBoxField.prototype, "borderColor", {
+        /**
+         * 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();
+         * ```
+         */
+        get: function () {
+            return this._parseBorderColor(true);
+        },
+        /**
+         * 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();
+         * ```
+         */
+        set: function (value) {
+            this._updateBorderColor(value, true);
+            if (this._isLoaded) {
+                this._setAppearance = true;
+            }
+        },
+        enumerable: true,
+        configurable: true
+    });
     PdfCheckBoxField.prototype._initialize = function (page, name, bounds) {
         this._crossReference = page._crossReference;
         this._page = page;
@@ -19719,7 +19823,9 @@ var PdfCheckBoxField = /** @__PURE__ @class */ (function (_super) {
         }
         parameter.foreBrush = new PdfBrush(widget.color);
         var border = widget.border;
-        parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        if (widget.borderColor) {
+            parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        }
         parameter.borderStyle = border.style;
         parameter.borderWidth = border.width;
         if (backcolor) {
@@ -19955,6 +20061,50 @@ var PdfRadioButtonListField = /** @__PURE__ @class */ (function (_super) {
         enumerable: true,
         configurable: true
     });
+    Object.defineProperty(PdfRadioButtonListField.prototype, "borderColor", {
+        /**
+         * 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();
+         * ```
+         */
+        get: function () {
+            return this._parseBorderColor(!this._isLoaded);
+        },
+        /**
+         * 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();
+         * ```
+         */
+        set: function (value) {
+            this._updateBorderColor(value, true);
+        },
+        enumerable: true,
+        configurable: true
+    });
     /**
      * Gets the item at the specified index.
      *
@@ -20210,7 +20360,9 @@ var PdfRadioButtonListField = /** @__PURE__ @class */ (function (_super) {
         }
         parameter.foreBrush = new PdfBrush(widget.color);
         var border = widget.border;
-        parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        if (widget.borderColor) {
+            parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        }
         parameter.borderStyle = border.style;
         parameter.borderWidth = border.width;
         if (backcolor) {
@@ -21625,7 +21777,9 @@ var PdfComboBoxField = /** @__PURE__ @class */ (function (_super) {
             }
             parameter.foreBrush = new PdfBrush(item.color);
             var border = item.border;
-            parameter.borderPen = new PdfPen(item.borderColor, border.width);
+            if (item.borderColor) {
+                parameter.borderPen = new PdfPen(item.borderColor, border.width);
+            }
             parameter.borderStyle = border.style;
             parameter.borderWidth = border.width;
             if (backcolor) {
@@ -21659,7 +21813,9 @@ var PdfComboBoxField = /** @__PURE__ @class */ (function (_super) {
             }
             parameter.foreBrush = new PdfBrush(this.color);
             var border = this.border;
-            parameter.borderPen = new PdfPen(this.borderColor, border.width);
+            if (this.borderColor) {
+                parameter.borderPen = new PdfPen(this.borderColor, border.width);
+            }
             parameter.borderStyle = border.style;
             parameter.borderWidth = border.width;
             if (backcolor) {
@@ -22011,7 +22167,9 @@ var PdfListBoxField = /** @__PURE__ @class */ (function (_super) {
             }
             parameter.foreBrush = new PdfBrush(item.color);
             var border = item.border;
-            parameter.borderPen = new PdfPen(item.borderColor, border.width);
+            if (item.borderColor) {
+                parameter.borderPen = new PdfPen(item.borderColor, border.width);
+            }
             parameter.borderStyle = border.style;
             parameter.borderWidth = border.width;
             if (backcolor) {
@@ -22043,7 +22201,9 @@ var PdfListBoxField = /** @__PURE__ @class */ (function (_super) {
             }
             parameter.foreBrush = new PdfBrush(this.color);
             var border = this.border;
-            parameter.borderPen = new PdfPen(this.borderColor, border.width);
+            if (this.borderColor) {
+                parameter.borderPen = new PdfPen(this.borderColor, border.width);
+            }
             parameter.borderStyle = border.style;
             parameter.borderWidth = border.width;
             if (backcolor) {
@@ -22353,7 +22513,7 @@ var PdfSignatureField = /** @__PURE__ @class */ (function (_super) {
     PdfSignatureField.prototype._doPostProcess = function (isFlatten) {
         if (isFlatten === void 0) { isFlatten = false; }
         var needAppearance = this._setAppearance || this._form._setAppearance;
-        if (!this._isLoaded && (isFlatten || needAppearance)) {
+        if (isFlatten || needAppearance) {
             var count = this._kidsCount;
             if (count > 0) {
                 for (var i = 0; i < count; i++) {
@@ -22401,7 +22561,9 @@ var PdfSignatureField = /** @__PURE__ @class */ (function (_super) {
         }
         parameter.foreBrush = new PdfBrush(widget.color);
         var border = widget.border;
-        parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        if (widget.borderColor) {
+            parameter.borderPen = new PdfPen(widget.borderColor, border.width);
+        }
         parameter.borderStyle = border.style;
         parameter.borderWidth = border.width;
         if (backcolor) {
@@ -34678,6 +34840,7 @@ var PdfWidgetAnnotation = /** @__PURE__ @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;
@@ -34841,6 +35004,19 @@ var PdfWidgetAnnotation = /** @__PURE__ @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.
@@ -34860,24 +35036,12 @@ var PdfWidgetAnnotation = /** @__PURE__ @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);
@@ -34894,15 +35058,7 @@ var PdfWidgetAnnotation = /** @__PURE__ @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
@@ -35536,6 +35692,25 @@ var PdfWidgetAnnotation = /** @__PURE__ @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;
@@ -35570,6 +35745,39 @@ var PdfWidgetAnnotation = /** @__PURE__ @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));
 /**