art-bd-ui 1.0.21 → 1.0.23

package/dist/esm/node_modules/pdf-lib/es/api/PDFPageOptions.js

@@ -0,0 +1,17 @@
+var BlendMode;
+(function (BlendMode) {
+    BlendMode["Normal"] = "Normal";
+    BlendMode["Multiply"] = "Multiply";
+    BlendMode["Screen"] = "Screen";
+    BlendMode["Overlay"] = "Overlay";
+    BlendMode["Darken"] = "Darken";
+    BlendMode["Lighten"] = "Lighten";
+    BlendMode["ColorDodge"] = "ColorDodge";
+    BlendMode["ColorBurn"] = "ColorBurn";
+    BlendMode["HardLight"] = "HardLight";
+    BlendMode["SoftLight"] = "SoftLight";
+    BlendMode["Difference"] = "Difference";
+    BlendMode["Exclusion"] = "Exclusion";
+})(BlendMode || (BlendMode = {}));
+
+export { BlendMode };

package/dist/esm/node_modules/pdf-lib/es/api/StandardFonts.js

@@ -0,0 +1,19 @@
+var StandardFonts;
+(function (StandardFonts) {
+    StandardFonts["Courier"] = "Courier";
+    StandardFonts["CourierBold"] = "Courier-Bold";
+    StandardFonts["CourierOblique"] = "Courier-Oblique";
+    StandardFonts["CourierBoldOblique"] = "Courier-BoldOblique";
+    StandardFonts["Helvetica"] = "Helvetica";
+    StandardFonts["HelveticaBold"] = "Helvetica-Bold";
+    StandardFonts["HelveticaOblique"] = "Helvetica-Oblique";
+    StandardFonts["HelveticaBoldOblique"] = "Helvetica-BoldOblique";
+    StandardFonts["TimesRoman"] = "Times-Roman";
+    StandardFonts["TimesRomanBold"] = "Times-Bold";
+    StandardFonts["TimesRomanItalic"] = "Times-Italic";
+    StandardFonts["TimesRomanBoldItalic"] = "Times-BoldItalic";
+    StandardFonts["Symbol"] = "Symbol";
+    StandardFonts["ZapfDingbats"] = "ZapfDingbats";
+})(StandardFonts || (StandardFonts = {}));
+
+export { StandardFonts };

package/dist/esm/node_modules/pdf-lib/es/api/colors.js

@@ -0,0 +1,64 @@
+import { setFillingGrayscaleColor, setFillingRgbColor, setFillingCmykColor, setStrokingGrayscaleColor, setStrokingRgbColor, setStrokingCmykColor } from './operators.js';
+import '../utils/base64.js';
+import '../utils/unicode.js';
+import { error } from '../utils/errors.js';
+import '../utils/objects.js';
+import { assertRange } from '../utils/validators.js';
+import '../utils/pdfDocEncoding.js';
+import '../utils/Cache.js';
+
+var ColorTypes;
+(function (ColorTypes) {
+    ColorTypes["Grayscale"] = "Grayscale";
+    ColorTypes["RGB"] = "RGB";
+    ColorTypes["CMYK"] = "CMYK";
+})(ColorTypes || (ColorTypes = {}));
+var grayscale = function (gray) {
+    assertRange(gray, 'gray', 0.0, 1.0);
+    return { type: ColorTypes.Grayscale, gray: gray };
+};
+var rgb = function (red, green, blue) {
+    assertRange(red, 'red', 0, 1);
+    assertRange(green, 'green', 0, 1);
+    assertRange(blue, 'blue', 0, 1);
+    return { type: ColorTypes.RGB, red: red, green: green, blue: blue };
+};
+var cmyk = function (cyan, magenta, yellow, key) {
+    assertRange(cyan, 'cyan', 0, 1);
+    assertRange(magenta, 'magenta', 0, 1);
+    assertRange(yellow, 'yellow', 0, 1);
+    assertRange(key, 'key', 0, 1);
+    return { type: ColorTypes.CMYK, cyan: cyan, magenta: magenta, yellow: yellow, key: key };
+};
+var Grayscale = ColorTypes.Grayscale, RGB = ColorTypes.RGB, CMYK = ColorTypes.CMYK;
+// prettier-ignore
+var setFillingColor = function (color) {
+    return color.type === Grayscale ? setFillingGrayscaleColor(color.gray)
+        : color.type === RGB ? setFillingRgbColor(color.red, color.green, color.blue)
+            : color.type === CMYK ? setFillingCmykColor(color.cyan, color.magenta, color.yellow, color.key)
+                : error("Invalid color: " + JSON.stringify(color));
+};
+// prettier-ignore
+var setStrokingColor = function (color) {
+    return color.type === Grayscale ? setStrokingGrayscaleColor(color.gray)
+        : color.type === RGB ? setStrokingRgbColor(color.red, color.green, color.blue)
+            : color.type === CMYK ? setStrokingCmykColor(color.cyan, color.magenta, color.yellow, color.key)
+                : error("Invalid color: " + JSON.stringify(color));
+};
+// prettier-ignore
+var componentsToColor = function (comps, scale) {
+    if (scale === void 0) { scale = 1; }
+    return ((comps === null || comps === void 0 ? void 0 : comps.length) === 1 ? grayscale(comps[0] * scale)
+        : (comps === null || comps === void 0 ? void 0 : comps.length) === 3 ? rgb(comps[0] * scale, comps[1] * scale, comps[2] * scale)
+            : (comps === null || comps === void 0 ? void 0 : comps.length) === 4 ? cmyk(comps[0] * scale, comps[1] * scale, comps[2] * scale, comps[3] * scale)
+                : undefined);
+};
+// prettier-ignore
+var colorToComponents = function (color) {
+    return color.type === Grayscale ? [color.gray]
+        : color.type === RGB ? [color.red, color.green, color.blue]
+            : color.type === CMYK ? [color.cyan, color.magenta, color.yellow, color.key]
+                : error("Invalid color: " + JSON.stringify(color));
+};
+
+export { ColorTypes, cmyk, colorToComponents, componentsToColor, grayscale, rgb, setFillingColor, setStrokingColor };

package/dist/esm/node_modules/pdf-lib/es/api/errors.js

@@ -0,0 +1,153 @@
+import { __extends } from '../../../tslib/tslib.es6.js';
+
+// tslint:disable: max-classes-per-file
+// TODO: Include link to documentation with example
+var EncryptedPDFError = /** @class */ (function (_super) {
+    __extends(EncryptedPDFError, _super);
+    function EncryptedPDFError() {
+        var _this = this;
+        var msg = 'Input document to `PDFDocument.load` is encrypted. You can use `PDFDocument.load(..., { ignoreEncryption: true })` if you wish to load the document anyways.';
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return EncryptedPDFError;
+}(Error));
+// TODO: Include link to documentation with example
+var FontkitNotRegisteredError = /** @class */ (function (_super) {
+    __extends(FontkitNotRegisteredError, _super);
+    function FontkitNotRegisteredError() {
+        var _this = this;
+        var msg = 'Input to `PDFDocument.embedFont` was a custom font, but no `fontkit` instance was found. You must register a `fontkit` instance with `PDFDocument.registerFontkit(...)` before embedding custom fonts.';
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return FontkitNotRegisteredError;
+}(Error));
+// TODO: Include link to documentation with example
+var ForeignPageError = /** @class */ (function (_super) {
+    __extends(ForeignPageError, _super);
+    function ForeignPageError() {
+        var _this = this;
+        var msg = 'A `page` passed to `PDFDocument.addPage` or `PDFDocument.insertPage` was from a different (foreign) PDF document. If you want to copy pages from one PDFDocument to another, you must use `PDFDocument.copyPages(...)` to copy the pages before adding or inserting them.';
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return ForeignPageError;
+}(Error));
+// TODO: Include link to documentation with example
+var RemovePageFromEmptyDocumentError = /** @class */ (function (_super) {
+    __extends(RemovePageFromEmptyDocumentError, _super);
+    function RemovePageFromEmptyDocumentError() {
+        var _this = this;
+        var msg = 'PDFDocument has no pages so `PDFDocument.removePage` cannot be called';
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return RemovePageFromEmptyDocumentError;
+}(Error));
+var NoSuchFieldError = /** @class */ (function (_super) {
+    __extends(NoSuchFieldError, _super);
+    function NoSuchFieldError(name) {
+        var _this = this;
+        var msg = "PDFDocument has no form field with the name \"" + name + "\"";
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return NoSuchFieldError;
+}(Error));
+var UnexpectedFieldTypeError = /** @class */ (function (_super) {
+    __extends(UnexpectedFieldTypeError, _super);
+    function UnexpectedFieldTypeError(name, expected, actual) {
+        var _a, _b;
+        var _this = this;
+        var expectedType = expected === null || expected === void 0 ? void 0 : expected.name;
+        var actualType = (_b = (_a = actual === null || actual === void 0 ? void 0 : actual.constructor) === null || _a === void 0 ? void 0 : _a.name) !== null && _b !== void 0 ? _b : actual;
+        var msg = "Expected field \"" + name + "\" to be of type " + expectedType + ", " +
+            ("but it is actually of type " + actualType);
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return UnexpectedFieldTypeError;
+}(Error));
+/** @class */ ((function (_super) {
+    __extends(MissingOnValueCheckError, _super);
+    function MissingOnValueCheckError(onValue) {
+        var _this = this;
+        var msg = "Failed to select check box due to missing onValue: \"" + onValue + "\"";
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return MissingOnValueCheckError;
+})(Error));
+var FieldAlreadyExistsError = /** @class */ (function (_super) {
+    __extends(FieldAlreadyExistsError, _super);
+    function FieldAlreadyExistsError(name) {
+        var _this = this;
+        var msg = "A field already exists with the specified name: \"" + name + "\"";
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return FieldAlreadyExistsError;
+}(Error));
+var InvalidFieldNamePartError = /** @class */ (function (_super) {
+    __extends(InvalidFieldNamePartError, _super);
+    function InvalidFieldNamePartError(namePart) {
+        var _this = this;
+        var msg = "Field name contains invalid component: \"" + namePart + "\"";
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return InvalidFieldNamePartError;
+}(Error));
+/** @class */ ((function (_super) {
+    __extends(FieldExistsAsNonTerminalError, _super);
+    function FieldExistsAsNonTerminalError(name) {
+        var _this = this;
+        var msg = "A non-terminal field already exists with the specified name: \"" + name + "\"";
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return FieldExistsAsNonTerminalError;
+})(Error));
+var RichTextFieldReadError = /** @class */ (function (_super) {
+    __extends(RichTextFieldReadError, _super);
+    function RichTextFieldReadError(fieldName) {
+        var _this = this;
+        var msg = "Reading rich text fields is not supported: Attempted to read rich text field: " + fieldName;
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return RichTextFieldReadError;
+}(Error));
+var CombedTextLayoutError = /** @class */ (function (_super) {
+    __extends(CombedTextLayoutError, _super);
+    function CombedTextLayoutError(lineLength, cellCount) {
+        var _this = this;
+        var msg = "Failed to layout combed text as lineLength=" + lineLength + " is greater than cellCount=" + cellCount;
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return CombedTextLayoutError;
+}(Error));
+var ExceededMaxLengthError = /** @class */ (function (_super) {
+    __extends(ExceededMaxLengthError, _super);
+    function ExceededMaxLengthError(textLength, maxLength, name) {
+        var _this = this;
+        var msg = "Attempted to set text with length=" + textLength + " for TextField with maxLength=" + maxLength + " and name=" + name;
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return ExceededMaxLengthError;
+}(Error));
+var InvalidMaxLengthError = /** @class */ (function (_super) {
+    __extends(InvalidMaxLengthError, _super);
+    function InvalidMaxLengthError(textLength, maxLength, name) {
+        var _this = this;
+        var msg = "Attempted to set maxLength=" + maxLength + ", which is less than " + textLength + ", the length of this field's current value (name=" + name + ")";
+        _this = _super.call(this, msg) || this;
+        return _this;
+    }
+    return InvalidMaxLengthError;
+}(Error));
+
+export { CombedTextLayoutError, EncryptedPDFError, ExceededMaxLengthError, FieldAlreadyExistsError, FontkitNotRegisteredError, ForeignPageError, InvalidFieldNamePartError, InvalidMaxLengthError, NoSuchFieldError, RemovePageFromEmptyDocumentError, RichTextFieldReadError, UnexpectedFieldTypeError };

package/dist/esm/node_modules/pdf-lib/es/api/form/PDFButton.js

@@ -0,0 +1,291 @@
+import { __extends } from '../../../../tslib/tslib.es6.js';
+import PDFPage from '../PDFPage.js';
+import PDFFont from '../PDFFont.js';
+import { ImageAlignment } from '../image/alignment.js';
+import { normalizeAppearance, defaultButtonAppearanceProvider } from './appearances.js';
+import PDFField, { assertFieldAppearanceOptions } from './PDFField.js';
+import { rgb } from '../colors.js';
+import { degrees } from '../rotations.js';
+import '../../core/errors.js';
+import '../../core/syntax/CharCodes.js';
+import '../../core/PDFContext.js';
+import '../../core/PDFObjectCopier.js';
+import '../../core/writers/PDFWriter.js';
+import '../../core/writers/PDFStreamWriter.js';
+import '../../core/document/PDFHeader.js';
+import '../../core/document/PDFTrailer.js';
+import '../../core/document/PDFTrailerDict.js';
+import '../../core/document/PDFCrossRefSection.js';
+import '../../core/embedders/StandardFontEmbedder.js';
+import '../../core/embedders/CustomFontEmbedder.js';
+import '../../core/embedders/CustomFontSubsetEmbedder.js';
+import '../../core/embedders/FileEmbedder.js';
+import '../../core/embedders/JpegEmbedder.js';
+import '../../core/embedders/PngEmbedder.js';
+import '../../core/embedders/PDFPageEmbedder.js';
+import '../../core/interactive/ViewerPreferences.js';
+import '../../core/objects/PDFObject.js';
+import '../../core/objects/PDFBool.js';
+import '../../core/objects/PDFNumber.js';
+import '../../core/objects/PDFString.js';
+import '../../core/objects/PDFHexString.js';
+import '../../core/objects/PDFName.js';
+import '../../core/objects/PDFNull.js';
+import '../../core/objects/PDFArray.js';
+import '../../core/objects/PDFDict.js';
+import '../../core/objects/PDFRef.js';
+import '../../core/objects/PDFInvalidObject.js';
+import PDFStream from '../../core/objects/PDFStream.js';
+import '../../core/objects/PDFRawStream.js';
+import '../../core/structures/PDFCatalog.js';
+import '../../core/structures/PDFContentStream.js';
+import '../../core/structures/PDFCrossRefStream.js';
+import '../../core/structures/PDFObjectStream.js';
+import '../../core/structures/PDFPageTree.js';
+import '../../core/structures/PDFPageLeaf.js';
+import '../../core/structures/PDFFlateStream.js';
+import '../../core/operators/PDFOperator.js';
+import '../../core/operators/PDFOperatorNames.js';
+import '../../core/parser/PDFObjectParser.js';
+import '../../core/parser/PDFObjectStreamParser.js';
+import '../../core/parser/PDFParser.js';
+import '../../core/parser/PDFXRefStreamParser.js';
+import '../../core/streams/Ascii85Stream.js';
+import '../../core/streams/AsciiHexStream.js';
+import '../../core/streams/FlateStream.js';
+import '../../core/streams/LZWStream.js';
+import '../../core/streams/RunLengthStream.js';
+import '../../core/streams/Stream.js';
+import '../../core/annotation/PDFAnnotation.js';
+import '../../core/annotation/PDFWidgetAnnotation.js';
+import '../../core/annotation/AppearanceCharacteristics.js';
+import '../../core/annotation/flags.js';
+import '../../core/acroform/PDFAcroButton.js';
+import '../../core/acroform/PDFAcroCheckBox.js';
+import '../../core/acroform/PDFAcroChoice.js';
+import '../../core/acroform/PDFAcroComboBox.js';
+import '../../core/acroform/PDFAcroField.js';
+import '../../core/acroform/PDFAcroForm.js';
+import '../../core/acroform/PDFAcroListBox.js';
+import '../../core/acroform/PDFAcroNonTerminal.js';
+import PDFAcroPushButton from '../../core/acroform/PDFAcroPushButton.js';
+import '../../core/acroform/PDFAcroRadioButton.js';
+import '../../core/acroform/PDFAcroSignature.js';
+import '../../core/acroform/PDFAcroTerminal.js';
+import '../../core/acroform/PDFAcroText.js';
+import '../../core/acroform/flags.js';
+import '../../utils/base64.js';
+import '../../utils/unicode.js';
+import '../../utils/objects.js';
+import { assertIs, assertPositive, assertOrUndefined } from '../../utils/validators.js';
+import '../../utils/pdfDocEncoding.js';
+import '../../utils/Cache.js';
+
+/**
+ * Represents a button field of a [[PDFForm]].
+ *
+ * [[PDFButton]] fields are interactive controls that users can click with their
+ * mouse. This type of [[PDFField]] is not stateful. The purpose of a button
+ * is to perform an action when the user clicks on it, such as opening a print
+ * modal or resetting the form. Buttons are typically rectangular in shape and
+ * have a text label describing the action that they perform when clicked.
+ */
+var PDFButton = /** @class */ (function (_super) {
+    __extends(PDFButton, _super);
+    function PDFButton(acroPushButton, ref, doc) {
+        var _this = _super.call(this, acroPushButton, ref, doc) || this;
+        assertIs(acroPushButton, 'acroButton', [
+            [PDFAcroPushButton, 'PDFAcroPushButton'],
+        ]);
+        _this.acroField = acroPushButton;
+        return _this;
+    }
+    /**
+     * Display an image inside the bounds of this button's widgets. For example:
+     * ```js
+     * const pngImage = await pdfDoc.embedPng(...)
+     * const button = form.getButton('some.button.field')
+     * button.setImage(pngImage, ImageAlignment.Center)
+     * ```
+     * This will update the appearances streams for each of this button's widgets.
+     * @param image The image that should be displayed.
+     * @param alignment The alignment of the image.
+     */
+    PDFButton.prototype.setImage = function (image, alignment) {
+        if (alignment === void 0) { alignment = ImageAlignment.Center; }
+        var widgets = this.acroField.getWidgets();
+        for (var idx = 0, len = widgets.length; idx < len; idx++) {
+            var widget = widgets[idx];
+            var streamRef = this.createImageAppearanceStream(widget, image, alignment);
+            this.updateWidgetAppearances(widget, { normal: streamRef });
+        }
+        this.markAsClean();
+    };
+    /**
+     * Set the font size for this field. Larger font sizes will result in larger
+     * text being displayed when PDF readers render this button. Font sizes may
+     * be integer or floating point numbers. Supplying a negative font size will
+     * cause this method to throw an error.
+     *
+     * For example:
+     * ```js
+     * const button = form.getButton('some.button.field')
+     * button.setFontSize(4)
+     * button.setFontSize(15.7)
+     * ```
+     *
+     * > This method depends upon the existence of a default appearance
+     * > (`/DA`) string. If this field does not have a default appearance string,
+     * > or that string does not contain a font size (via the `Tf` operator),
+     * > then this method will throw an error.
+     *
+     * @param fontSize The font size to be used when rendering text in this field.
+     */
+    PDFButton.prototype.setFontSize = function (fontSize) {
+        assertPositive(fontSize, 'fontSize');
+        this.acroField.setFontSize(fontSize);
+        this.markAsDirty();
+    };
+    /**
+     * Show this button on the specified page with the given text. For example:
+     * ```js
+     * const ubuntuFont = await pdfDoc.embedFont(ubuntuFontBytes)
+     * const page = pdfDoc.addPage()
+     *
+     * const form = pdfDoc.getForm()
+     * const button = form.createButton('some.button.field')
+     *
+     * button.addToPage('Do Stuff', page, {
+     *   x: 50,
+     *   y: 75,
+     *   width: 200,
+     *   height: 100,
+     *   textColor: rgb(1, 0, 0),
+     *   backgroundColor: rgb(0, 1, 0),
+     *   borderColor: rgb(0, 0, 1),
+     *   borderWidth: 2,
+     *   rotate: degrees(90),
+     *   font: ubuntuFont,
+     * })
+     * ```
+     * This will create a new widget for this button field.
+     * @param text The text to be displayed for this button widget.
+     * @param page The page to which this button widget should be added.
+     * @param options The options to be used when adding this button widget.
+     */
+    PDFButton.prototype.addToPage = function (
+    // TODO: This needs to be optional, e.g. for image buttons
+    text, page, options) {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l;
+        assertOrUndefined(text, 'text', ['string']);
+        assertOrUndefined(page, 'page', [[PDFPage, 'PDFPage']]);
+        assertFieldAppearanceOptions(options);
+        // Create a widget for this button
+        var widget = this.createWidget({
+            x: ((_a = options === null || options === void 0 ? void 0 : options.x) !== null && _a !== void 0 ? _a : 0) - ((_b = options === null || options === void 0 ? void 0 : options.borderWidth) !== null && _b !== void 0 ? _b : 0) / 2,
+            y: ((_c = options === null || options === void 0 ? void 0 : options.y) !== null && _c !== void 0 ? _c : 0) - ((_d = options === null || options === void 0 ? void 0 : options.borderWidth) !== null && _d !== void 0 ? _d : 0) / 2,
+            width: (_e = options === null || options === void 0 ? void 0 : options.width) !== null && _e !== void 0 ? _e : 100,
+            height: (_f = options === null || options === void 0 ? void 0 : options.height) !== null && _f !== void 0 ? _f : 50,
+            textColor: (_g = options === null || options === void 0 ? void 0 : options.textColor) !== null && _g !== void 0 ? _g : rgb(0, 0, 0),
+            backgroundColor: (_h = options === null || options === void 0 ? void 0 : options.backgroundColor) !== null && _h !== void 0 ? _h : rgb(0.75, 0.75, 0.75),
+            borderColor: options === null || options === void 0 ? void 0 : options.borderColor,
+            borderWidth: (_j = options === null || options === void 0 ? void 0 : options.borderWidth) !== null && _j !== void 0 ? _j : 0,
+            rotate: (_k = options === null || options === void 0 ? void 0 : options.rotate) !== null && _k !== void 0 ? _k : degrees(0),
+            caption: text,
+            hidden: options === null || options === void 0 ? void 0 : options.hidden,
+            page: page.ref,
+        });
+        var widgetRef = this.doc.context.register(widget.dict);
+        // Add widget to this field
+        this.acroField.addWidget(widgetRef);
+        // Set appearance streams for widget
+        var font = (_l = options === null || options === void 0 ? void 0 : options.font) !== null && _l !== void 0 ? _l : this.doc.getForm().getDefaultFont();
+        this.updateWidgetAppearance(widget, font);
+        // Add widget to the given page
+        page.node.addAnnot(widgetRef);
+    };
+    /**
+     * Returns `true` if this button has been marked as dirty, or if any of this
+     * button's widgets do not have an appearance stream. For example:
+     * ```js
+     * const button = form.getButton('some.button.field')
+     * if (button.needsAppearancesUpdate()) console.log('Needs update')
+     * ```
+     * @returns Whether or not this button needs an appearance update.
+     */
+    PDFButton.prototype.needsAppearancesUpdate = function () {
+        var _a;
+        if (this.isDirty())
+            return true;
+        var widgets = this.acroField.getWidgets();
+        for (var idx = 0, len = widgets.length; idx < len; idx++) {
+            var widget = widgets[idx];
+            var hasAppearances = ((_a = widget.getAppearances()) === null || _a === void 0 ? void 0 : _a.normal) instanceof PDFStream;
+            if (!hasAppearances)
+                return true;
+        }
+        return false;
+    };
+    /**
+     * Update the appearance streams for each of this button's widgets using
+     * the default appearance provider for buttons. For example:
+     * ```js
+     * const helvetica = await pdfDoc.embedFont(StandardFonts.Helvetica)
+     * const button = form.getButton('some.button.field')
+     * button.defaultUpdateAppearances(helvetica)
+     * ```
+     * @param font The font to be used for creating the appearance streams.
+     */
+    PDFButton.prototype.defaultUpdateAppearances = function (font) {
+        assertIs(font, 'font', [[PDFFont, 'PDFFont']]);
+        this.updateAppearances(font);
+    };
+    /**
+     * Update the appearance streams for each of this button's widgets using
+     * the given appearance provider. If no `provider` is passed, the default
+     * appearance provider for buttons will be used. For example:
+     * ```js
+     * const helvetica = await pdfDoc.embedFont(StandardFonts.Helvetica)
+     * const button = form.getButton('some.button.field')
+     * button.updateAppearances(helvetica, (field, widget, font) => {
+     *   ...
+     *   return {
+     *     normal: drawButton(...),
+     *     down: drawButton(...),
+     *   }
+     * })
+     * ```
+     * @param font The font to be used for creating the appearance streams.
+     * @param provider Optionally, the appearance provider to be used for
+     *                 generating the contents of the appearance streams.
+     */
+    PDFButton.prototype.updateAppearances = function (font, provider) {
+        assertIs(font, 'font', [[PDFFont, 'PDFFont']]);
+        assertOrUndefined(provider, 'provider', [Function]);
+        var widgets = this.acroField.getWidgets();
+        for (var idx = 0, len = widgets.length; idx < len; idx++) {
+            var widget = widgets[idx];
+            this.updateWidgetAppearance(widget, font, provider);
+        }
+    };
+    PDFButton.prototype.updateWidgetAppearance = function (widget, font, provider) {
+        var apProvider = provider !== null && provider !== void 0 ? provider : defaultButtonAppearanceProvider;
+        var appearances = normalizeAppearance(apProvider(this, widget, font));
+        this.updateWidgetAppearanceWithFont(widget, font, appearances);
+    };
+    /**
+     * > **NOTE:** You probably don't want to call this method directly. Instead,
+     * > consider using the [[PDFForm.getButton]] method, which will create an
+     * > instance of [[PDFButton]] for you.
+     *
+     * Create an instance of [[PDFButton]] from an existing acroPushButton and ref
+     *
+     * @param acroPushButton The underlying `PDFAcroPushButton` for this button.
+     * @param ref The unique reference for this button.
+     * @param doc The document to which this button will belong.
+     */
+    PDFButton.of = function (acroPushButton, ref, doc) { return new PDFButton(acroPushButton, ref, doc); };
+    return PDFButton;
+}(PDFField));
+
+export { PDFButton as default };