pdfkit 0.10.0 → 0.11.0

package/js/pdfkit.esnext.js

@@ -7,8 +7,8 @@ import { EventEmitter } from 'events';
 import LineBreaker from 'linebreak';
 import PNG from 'png-js';
 
-/*
-PDFAbstractReference - abstract class for PDF reference
+/*
+PDFAbstractReference - abstract class for PDF reference
 */
 class PDFAbstractReference {
   toString() {
@@ -17,8 +17,8 @@ class PDFAbstractReference {
 
 }
 
-/*
-PDFNameTree - represents a name tree object
+/*
+PDFNameTree - represents a name tree object
 */
 
 class PDFNameTree {
@@ -58,9 +58,9 @@ class PDFNameTree {
 
 }
 
-/*
-PDFObject - converts JavaScript types into their corresponding PDF types.
-By Devon Govett
+/*
+PDFObject - converts JavaScript types into their corresponding PDF types.
+By Devon Govett
 */
 
 var pad = (str, length) => (Array(length + 1).join('0') + str).slice(-length);
@@ -176,9 +176,9 @@ class PDFObject {
 
 }
 
-/*
-PDFReference - represents a reference to another object in the PDF object heirarchy
-By Devon Govett
+/*
+PDFReference - represents a reference to another object in the PDF object heirarchy
+By Devon Govett
 */
 
 class PDFReference extends PDFAbstractReference {
@@ -264,9 +264,9 @@ class PDFReference extends PDFAbstractReference {
 
 }
 
-/*
-PDFPage - represents a single page in the PDF document
-By Devon Govett
+/*
+PDFPage - represents a single page in the PDF document
+By Devon Govett
 */
 var DEFAULT_MARGINS = {
   top: 72,
@@ -406,11 +406,11 @@ class PDFPage {
 
 }
 
-/**
- * Check if value is in a range group.
- * @param {number} value
- * @param {number[]} rangeGroup
- * @returns {boolean}
+/**
+ * Check if value is in a range group.
+ * @param {number} value
+ * @param {number[]} rangeGroup
+ * @returns {boolean}
  */
 function inRange(value, rangeGroup) {
   if (value < rangeGroup[0]) return false;
@@ -440,9 +440,9 @@ function inRange(value, rangeGroup) {
 
 /* eslint-disable prettier/prettier */
 
-/**
- * A.1 Unassigned code points in Unicode 3.2
- * @link https://tools.ietf.org/html/rfc3454#appendix-A.1
+/**
+ * A.1 Unassigned code points in Unicode 3.2
+ * @link https://tools.ietf.org/html/rfc3454#appendix-A.1
  */
 
 var unassigned_code_points = [0x0221, 0x0221, 0x0234, 0x024f, 0x02ae, 0x02af, 0x02ef, 0x02ff, 0x0350, 0x035f, 0x0370, 0x0373, 0x0376, 0x0379, 0x037b, 0x037d, 0x037f, 0x0383, 0x038b, 0x038b, 0x038d, 0x038d, 0x03a2, 0x03a2, 0x03cf, 0x03cf, 0x03f7, 0x03ff, 0x0487, 0x0487, 0x04cf, 0x04cf, 0x04f6, 0x04f7, 0x04fa, 0x04ff, 0x0510, 0x0530, 0x0557, 0x0558, 0x0560, 0x0560, 0x0588, 0x0588, 0x058b, 0x0590, 0x05a2, 0x05a2, 0x05ba, 0x05ba, 0x05c5, 0x05cf, 0x05eb, 0x05ef, 0x05f5, 0x060b, 0x060d, 0x061a, 0x061c, 0x061e, 0x0620, 0x0620, 0x063b, 0x063f, 0x0656, 0x065f, 0x06ee, 0x06ef, 0x06ff, 0x06ff, 0x070e, 0x070e, 0x072d, 0x072f, 0x074b, 0x077f, 0x07b2, 0x0900, 0x0904, 0x0904, 0x093a, 0x093b, 0x094e, 0x094f, 0x0955, 0x0957, 0x0971, 0x0980, 0x0984, 0x0984, 0x098d, 0x098e, 0x0991, 0x0992, 0x09a9, 0x09a9, 0x09b1, 0x09b1, 0x09b3, 0x09b5, 0x09ba, 0x09bb, 0x09bd, 0x09bd, 0x09c5, 0x09c6, 0x09c9, 0x09ca, 0x09ce, 0x09d6, 0x09d8, 0x09db, 0x09de, 0x09de, 0x09e4, 0x09e5, 0x09fb, 0x0a01, 0x0a03, 0x0a04, 0x0a0b, 0x0a0e, 0x0a11, 0x0a12, 0x0a29, 0x0a29, 0x0a31, 0x0a31, 0x0a34, 0x0a34, 0x0a37, 0x0a37, 0x0a3a, 0x0a3b, 0x0a3d, 0x0a3d, 0x0a43, 0x0a46, 0x0a49, 0x0a4a, 0x0a4e, 0x0a58, 0x0a5d, 0x0a5d, 0x0a5f, 0x0a65, 0x0a75, 0x0a80, 0x0a84, 0x0a84, 0x0a8c, 0x0a8c, 0x0a8e, 0x0a8e, 0x0a92, 0x0a92, 0x0aa9, 0x0aa9, 0x0ab1, 0x0ab1, 0x0ab4, 0x0ab4, 0x0aba, 0x0abb, 0x0ac6, 0x0ac6, 0x0aca, 0x0aca, 0x0ace, 0x0acf, 0x0ad1, 0x0adf, 0x0ae1, 0x0ae5, 0x0af0, 0x0b00, 0x0b04, 0x0b04, 0x0b0d, 0x0b0e, 0x0b11, 0x0b12, 0x0b29, 0x0b29, 0x0b31, 0x0b31, 0x0b34, 0x0b35, 0x0b3a, 0x0b3b, 0x0b44, 0x0b46, 0x0b49, 0x0b4a, 0x0b4e, 0x0b55, 0x0b58, 0x0b5b, 0x0b5e, 0x0b5e, 0x0b62, 0x0b65, 0x0b71, 0x0b81, 0x0b84, 0x0b84, 0x0b8b, 0x0b8d, 0x0b91, 0x0b91, 0x0b96, 0x0b98, 0x0b9b, 0x0b9b, 0x0b9d, 0x0b9d, 0x0ba0, 0x0ba2, 0x0ba5, 0x0ba7, 0x0bab, 0x0bad, 0x0bb6, 0x0bb6, 0x0bba, 0x0bbd, 0x0bc3, 0x0bc5, 0x0bc9, 0x0bc9, 0x0bce, 0x0bd6, 0x0bd8, 0x0be6, 0x0bf3, 0x0c00, 0x0c04, 0x0c04, 0x0c0d, 0x0c0d, 0x0c11, 0x0c11, 0x0c29, 0x0c29, 0x0c34, 0x0c34, 0x0c3a, 0x0c3d, 0x0c45, 0x0c45, 0x0c49, 0x0c49, 0x0c4e, 0x0c54, 0x0c57, 0x0c5f, 0x0c62, 0x0c65, 0x0c70, 0x0c81, 0x0c84, 0x0c84, 0x0c8d, 0x0c8d, 0x0c91, 0x0c91, 0x0ca9, 0x0ca9, 0x0cb4, 0x0cb4, 0x0cba, 0x0cbd, 0x0cc5, 0x0cc5, 0x0cc9, 0x0cc9, 0x0cce, 0x0cd4, 0x0cd7, 0x0cdd, 0x0cdf, 0x0cdf, 0x0ce2, 0x0ce5, 0x0cf0, 0x0d01, 0x0d04, 0x0d04, 0x0d0d, 0x0d0d, 0x0d11, 0x0d11, 0x0d29, 0x0d29, 0x0d3a, 0x0d3d, 0x0d44, 0x0d45, 0x0d49, 0x0d49, 0x0d4e, 0x0d56, 0x0d58, 0x0d5f, 0x0d62, 0x0d65, 0x0d70, 0x0d81, 0x0d84, 0x0d84, 0x0d97, 0x0d99, 0x0db2, 0x0db2, 0x0dbc, 0x0dbc, 0x0dbe, 0x0dbf, 0x0dc7, 0x0dc9, 0x0dcb, 0x0dce, 0x0dd5, 0x0dd5, 0x0dd7, 0x0dd7, 0x0de0, 0x0df1, 0x0df5, 0x0e00, 0x0e3b, 0x0e3e, 0x0e5c, 0x0e80, 0x0e83, 0x0e83, 0x0e85, 0x0e86, 0x0e89, 0x0e89, 0x0e8b, 0x0e8c, 0x0e8e, 0x0e93, 0x0e98, 0x0e98, 0x0ea0, 0x0ea0, 0x0ea4, 0x0ea4, 0x0ea6, 0x0ea6, 0x0ea8, 0x0ea9, 0x0eac, 0x0eac, 0x0eba, 0x0eba, 0x0ebe, 0x0ebf, 0x0ec5, 0x0ec5, 0x0ec7, 0x0ec7, 0x0ece, 0x0ecf, 0x0eda, 0x0edb, 0x0ede, 0x0eff, 0x0f48, 0x0f48, 0x0f6b, 0x0f70, 0x0f8c, 0x0f8f, 0x0f98, 0x0f98, 0x0fbd, 0x0fbd, 0x0fcd, 0x0fce, 0x0fd0, 0x0fff, 0x1022, 0x1022, 0x1028, 0x1028, 0x102b, 0x102b, 0x1033, 0x1035, 0x103a, 0x103f, 0x105a, 0x109f, 0x10c6, 0x10cf, 0x10f9, 0x10fa, 0x10fc, 0x10ff, 0x115a, 0x115e, 0x11a3, 0x11a7, 0x11fa, 0x11ff, 0x1207, 0x1207, 0x1247, 0x1247, 0x1249, 0x1249, 0x124e, 0x124f, 0x1257, 0x1257, 0x1259, 0x1259, 0x125e, 0x125f, 0x1287, 0x1287, 0x1289, 0x1289, 0x128e, 0x128f, 0x12af, 0x12af, 0x12b1, 0x12b1, 0x12b6, 0x12b7, 0x12bf, 0x12bf, 0x12c1, 0x12c1, 0x12c6, 0x12c7, 0x12cf, 0x12cf, 0x12d7, 0x12d7, 0x12ef, 0x12ef, 0x130f, 0x130f, 0x1311, 0x1311, 0x1316, 0x1317, 0x131f, 0x131f, 0x1347, 0x1347, 0x135b, 0x1360, 0x137d, 0x139f, 0x13f5, 0x1400, 0x1677, 0x167f, 0x169d, 0x169f, 0x16f1, 0x16ff, 0x170d, 0x170d, 0x1715, 0x171f, 0x1737, 0x173f, 0x1754, 0x175f, 0x176d, 0x176d, 0x1771, 0x1771, 0x1774, 0x177f, 0x17dd, 0x17df, 0x17ea, 0x17ff, 0x180f, 0x180f, 0x181a, 0x181f, 0x1878, 0x187f, 0x18aa, 0x1dff, 0x1e9c, 0x1e9f, 0x1efa, 0x1eff, 0x1f16, 0x1f17, 0x1f1e, 0x1f1f, 0x1f46, 0x1f47, 0x1f4e, 0x1f4f, 0x1f58, 0x1f58, 0x1f5a, 0x1f5a, 0x1f5c, 0x1f5c, 0x1f5e, 0x1f5e, 0x1f7e, 0x1f7f, 0x1fb5, 0x1fb5, 0x1fc5, 0x1fc5, 0x1fd4, 0x1fd5, 0x1fdc, 0x1fdc, 0x1ff0, 0x1ff1, 0x1ff5, 0x1ff5, 0x1fff, 0x1fff, 0x2053, 0x2056, 0x2058, 0x205e, 0x2064, 0x2069, 0x2072, 0x2073, 0x208f, 0x209f, 0x20b2, 0x20cf, 0x20eb, 0x20ff, 0x213b, 0x213c, 0x214c, 0x2152, 0x2184, 0x218f, 0x23cf, 0x23ff, 0x2427, 0x243f, 0x244b, 0x245f, 0x24ff, 0x24ff, 0x2614, 0x2615, 0x2618, 0x2618, 0x267e, 0x267f, 0x268a, 0x2700, 0x2705, 0x2705, 0x270a, 0x270b, 0x2728, 0x2728, 0x274c, 0x274c, 0x274e, 0x274e, 0x2753, 0x2755, 0x2757, 0x2757, 0x275f, 0x2760, 0x2795, 0x2797, 0x27b0, 0x27b0, 0x27bf, 0x27cf, 0x27ec, 0x27ef, 0x2b00, 0x2e7f, 0x2e9a, 0x2e9a, 0x2ef4, 0x2eff, 0x2fd6, 0x2fef, 0x2ffc, 0x2fff, 0x3040, 0x3040, 0x3097, 0x3098, 0x3100, 0x3104, 0x312d, 0x3130, 0x318f, 0x318f, 0x31b8, 0x31ef, 0x321d, 0x321f, 0x3244, 0x3250, 0x327c, 0x327e, 0x32cc, 0x32cf, 0x32ff, 0x32ff, 0x3377, 0x337a, 0x33de, 0x33df, 0x33ff, 0x33ff, 0x4db6, 0x4dff, 0x9fa6, 0x9fff, 0xa48d, 0xa48f, 0xa4c7, 0xabff, 0xd7a4, 0xd7ff, 0xfa2e, 0xfa2f, 0xfa6b, 0xfaff, 0xfb07, 0xfb12, 0xfb18, 0xfb1c, 0xfb37, 0xfb37, 0xfb3d, 0xfb3d, 0xfb3f, 0xfb3f, 0xfb42, 0xfb42, 0xfb45, 0xfb45, 0xfbb2, 0xfbd2, 0xfd40, 0xfd4f, 0xfd90, 0xfd91, 0xfdc8, 0xfdcf, 0xfdfd, 0xfdff, 0xfe10, 0xfe1f, 0xfe24, 0xfe2f, 0xfe47, 0xfe48, 0xfe53, 0xfe53, 0xfe67, 0xfe67, 0xfe6c, 0xfe6f, 0xfe75, 0xfe75, 0xfefd, 0xfefe, 0xff00, 0xff00, 0xffbf, 0xffc1, 0xffc8, 0xffc9, 0xffd0, 0xffd1, 0xffd8, 0xffd9, 0xffdd, 0xffdf, 0xffe7, 0xffe7, 0xffef, 0xfff8, 0x10000, 0x102ff, 0x1031f, 0x1031f, 0x10324, 0x1032f, 0x1034b, 0x103ff, 0x10426, 0x10427, 0x1044e, 0x1cfff, 0x1d0f6, 0x1d0ff, 0x1d127, 0x1d129, 0x1d1de, 0x1d3ff, 0x1d455, 0x1d455, 0x1d49d, 0x1d49d, 0x1d4a0, 0x1d4a1, 0x1d4a3, 0x1d4a4, 0x1d4a7, 0x1d4a8, 0x1d4ad, 0x1d4ad, 0x1d4ba, 0x1d4ba, 0x1d4bc, 0x1d4bc, 0x1d4c1, 0x1d4c1, 0x1d4c4, 0x1d4c4, 0x1d506, 0x1d506, 0x1d50b, 0x1d50c, 0x1d515, 0x1d515, 0x1d51d, 0x1d51d, 0x1d53a, 0x1d53a, 0x1d53f, 0x1d53f, 0x1d545, 0x1d545, 0x1d547, 0x1d549, 0x1d551, 0x1d551, 0x1d6a4, 0x1d6a7, 0x1d7ca, 0x1d7cd, 0x1d800, 0x1fffd, 0x2a6d7, 0x2f7ff, 0x2fa1e, 0x2fffd, 0x30000, 0x3fffd, 0x40000, 0x4fffd, 0x50000, 0x5fffd, 0x60000, 0x6fffd, 0x70000, 0x7fffd, 0x80000, 0x8fffd, 0x90000, 0x9fffd, 0xa0000, 0xafffd, 0xb0000, 0xbfffd, 0xc0000, 0xcfffd, 0xd0000, 0xdfffd, 0xe0000, 0xe0000, 0xe0002, 0xe001f, 0xe0080, 0xefffd];
@@ -451,9 +451,9 @@ var unassigned_code_points = [0x0221, 0x0221, 0x0234, 0x024f, 0x02ae, 0x02af, 0x
 var isUnassignedCodePoint = character => inRange(character, unassigned_code_points);
 /* eslint-disable prettier/prettier */
 
-/**
- * B.1 Commonly mapped to nothing
- * @link https://tools.ietf.org/html/rfc3454#appendix-B.1
+/**
+ * B.1 Commonly mapped to nothing
+ * @link https://tools.ietf.org/html/rfc3454#appendix-B.1
  */
 
 
@@ -463,9 +463,9 @@ var commonly_mapped_to_nothing = [0x00ad, 0x00ad, 0x034f, 0x034f, 0x1806, 0x1806
 var isCommonlyMappedToNothing = character => inRange(character, commonly_mapped_to_nothing);
 /* eslint-disable prettier/prettier */
 
-/**
- * C.1.2 Non-ASCII space characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.1.2
+/**
+ * C.1.2 Non-ASCII space characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.1.2
  */
 
 
@@ -511,9 +511,9 @@ var isNonASCIISpaceCharacter = character => inRange(character, non_ASCII_space_c
 
 
 var non_ASCII_controls_characters = [
-/**
- * C.2.2 Non-ASCII control characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.2
+/**
+ * C.2.2 Non-ASCII control characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.2
  */
 0x0080, 0x009f
 /* [CONTROL CHARACTERS] */
@@ -549,9 +549,9 @@ var non_ASCII_controls_characters = [
 /* [MUSICAL CONTROL CHARACTERS] */
 ];
 var non_character_codepoints = [
-/**
- * C.4 Non-character code points
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.4
+/**
+ * C.4 Non-character code points
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.4
  */
 0xfdd0, 0xfdef
 /* [NONCHARACTER CODE POINTS] */
@@ -588,23 +588,23 @@ var non_character_codepoints = [
 , 0x10fffe, 0x10ffff
 /* [NONCHARACTER CODE POINTS] */
 ];
-/**
- * 2.3.  Prohibited Output
+/**
+ * 2.3.  Prohibited Output
  */
 
 var prohibited_characters = [
-/**
- * C.2.1 ASCII control characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.1
+/**
+ * C.2.1 ASCII control characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.2.1
  */
 0, 0x001f
 /* [CONTROL CHARACTERS] */
 , 0x007f, 0x007f
 /* DELETE */
 ,
-/**
- * C.8 Change display properties or are deprecated
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.8
+/**
+ * C.8 Change display properties or are deprecated
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.8
  */
 0x0340, 0x0340
 /* COMBINING GRAVE TONE MARK */
@@ -637,28 +637,28 @@ var prohibited_characters = [
 , 0x206f, 0x206f
 /* NOMINAL DIGIT SHAPES */
 ,
-/**
- * C.7 Inappropriate for canonical representation
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.7
+/**
+ * C.7 Inappropriate for canonical representation
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.7
  */
 0x2ff0, 0x2ffb
 /* [IDEOGRAPHIC DESCRIPTION CHARACTERS] */
 ,
-/**
- * C.5 Surrogate codes
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.5
+/**
+ * C.5 Surrogate codes
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.5
  */
 0xd800, 0xdfff,
-/**
- * C.3 Private use
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
+/**
+ * C.3 Private use
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
  */
 0xe000, 0xf8ff
 /* [PRIVATE USE, PLANE 0] */
 ,
-/**
- * C.6 Inappropriate for plain text
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.6
+/**
+ * C.6 Inappropriate for plain text
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.6
  */
 0xfff9, 0xfff9
 /* INTERLINEAR ANNOTATION ANCHOR */
@@ -671,18 +671,18 @@ var prohibited_characters = [
 , 0xfffd, 0xfffd
 /* REPLACEMENT CHARACTER */
 ,
-/**
- * C.9 Tagging characters
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.9
+/**
+ * C.9 Tagging characters
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.9
  */
 0xe0001, 0xe0001
 /* LANGUAGE TAG */
 , 0xe0020, 0xe007f
 /* [TAGGING CHARACTERS] */
 ,
-/**
- * C.3 Private use
- * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
+/**
+ * C.3 Private use
+ * @link https://tools.ietf.org/html/rfc3454#appendix-C.3
  */
 0xf0000, 0xffffd
 /* [PRIVATE USE, PLANE 15] */
@@ -694,9 +694,9 @@ var prohibited_characters = [
 var isProhibitedCharacter = character => inRange(character, non_ASCII_space_characters) || inRange(character, prohibited_characters) || inRange(character, non_ASCII_controls_characters) || inRange(character, non_character_codepoints);
 /* eslint-disable prettier/prettier */
 
-/**
- * D.1 Characters with bidirectional property "R" or "AL"
- * @link https://tools.ietf.org/html/rfc3454#appendix-D.1
+/**
+ * D.1 Characters with bidirectional property "R" or "AL"
+ * @link https://tools.ietf.org/html/rfc3454#appendix-D.1
  */
 
 
@@ -706,9 +706,9 @@ var bidirectional_r_al = [0x05be, 0x05be, 0x05c0, 0x05c0, 0x05c3, 0x05c3, 0x05d0
 var isBidirectionalRAL = character => inRange(character, bidirectional_r_al);
 /* eslint-disable prettier/prettier */
 
-/**
- * D.2 Characters with bidirectional property "L"
- * @link https://tools.ietf.org/html/rfc3454#appendix-D.2
+/**
+ * D.2 Characters with bidirectional property "L"
+ * @link https://tools.ietf.org/html/rfc3454#appendix-D.2
  */
 
 
@@ -717,15 +717,15 @@ var bidirectional_l = [0x0041, 0x005a, 0x0061, 0x007a, 0x00aa, 0x00aa, 0x00b5, 0
 
 var isBidirectionalL = character => inRange(character, bidirectional_l);
 
-/**
- * non-ASCII space characters [StringPrep, C.1.2] that can be
- * mapped to SPACE (U+0020)
+/**
+ * non-ASCII space characters [StringPrep, C.1.2] that can be
+ * mapped to SPACE (U+0020)
  */
 
 var mapping2space = isNonASCIISpaceCharacter;
-/**
- * the "commonly mapped to nothing" characters [StringPrep, B.1]
- * that can be mapped to nothing.
+/**
+ * the "commonly mapped to nothing" characters [StringPrep, B.1]
+ * that can be mapped to nothing.
  */
 
 var mapping2nothing = isCommonlyMappedToNothing; // utils
@@ -735,12 +735,12 @@ var getCodePoint = character => character.codePointAt(0);
 var first = x => x[0];
 
 var last = x => x[x.length - 1];
-/**
- * Convert provided string into an array of Unicode Code Points.
- * Based on https://stackoverflow.com/a/21409165/1556249
- * and https://www.npmjs.com/package/code-point-at.
- * @param {string} input
- * @returns {number[]}
+/**
+ * Convert provided string into an array of Unicode Code Points.
+ * Based on https://stackoverflow.com/a/21409165/1556249
+ * and https://www.npmjs.com/package/code-point-at.
+ * @param {string} input
+ * @returns {number[]}
  */
 
 
@@ -766,12 +766,12 @@ function toCodePoints(input) {
 
   return codepoints;
 }
-/**
- * SASLprep.
- * @param {string} input
- * @param {Object} opts
- * @param {boolean} opts.allowUnassigned
- * @returns {string}
+/**
+ * SASLprep.
+ * @param {string} input
+ * @param {Object} opts
+ * @param {boolean} opts.allowUnassigned
+ * @returns {string}
  */
 
 
@@ -817,10 +817,10 @@ function saslprep(input) {
   if (hasBidiRAL && hasBidiL) {
     throw new Error('String must not contain RandALCat and LCat at the same time,' + ' see https://tools.ietf.org/html/rfc3454#section-6');
   }
-  /**
-   * 4.2 If a string contains any RandALCat character, a RandALCat
-   * character MUST be the first character of the string, and a
-   * RandALCat character MUST be the last character of the string.
+  /**
+   * 4.2 If a string contains any RandALCat character, a RandALCat
+   * character MUST be the first character of the string, and a
+   * RandALCat character MUST be the last character of the string.
    */
 
 
@@ -834,9 +834,9 @@ function saslprep(input) {
   return normalized_input;
 }
 
-/*
-   PDFSecurity - represents PDF security settings
-   By Yang Liu <hi@zesik.com>
+/*
+   PDFSecurity - represents PDF security settings
+   By Yang Liu <hi@zesik.com>
  */
 
 class PDFSecurity {
@@ -849,7 +849,7 @@ class PDFSecurity {
         continue;
       }
 
-      infoStr += "".concat(key, ": ").concat(info[key].toString(), "\n");
+      infoStr += "".concat(key, ": ").concat(info[key], "\n");
     }
 
     return wordArrayToBuffer(CryptoJS.MD5(infoStr));
@@ -1272,45 +1272,9 @@ function wordArrayToBuffer(wordArray) {
 
 var PASSWORD_PADDING = [0x28, 0xbf, 0x4e, 0x5e, 0x4e, 0x75, 0x8a, 0x41, 0x64, 0x00, 0x4e, 0x56, 0xff, 0xfa, 0x01, 0x08, 0x2e, 0x2e, 0x00, 0xb6, 0xd0, 0x68, 0x3e, 0x80, 0x2f, 0x0c, 0xa9, 0xfe, 0x64, 0x53, 0x69, 0x7a];
 
-function _slicedToArray(arr, i) {
-  return _arrayWithHoles(arr) || _iterableToArrayLimit(arr, i) || _nonIterableRest();
-}
-
-function _arrayWithHoles(arr) {
-  if (Array.isArray(arr)) return arr;
-}
-
-function _iterableToArrayLimit(arr, i) {
-  var _arr = [];
-  var _n = true;
-  var _d = false;
-  var _e = undefined;
-
-  try {
-    for (var _i = arr[Symbol.iterator](), _s; !(_n = (_s = _i.next()).done); _n = true) {
-      _arr.push(_s.value);
-
-      if (i && _arr.length === i) break;
-    }
-  } catch (err) {
-    _d = true;
-    _e = err;
-  } finally {
-    try {
-      if (!_n && _i["return"] != null) _i["return"]();
-    } finally {
-      if (_d) throw _e;
-    }
-  }
-
-  return _arr;
-}
-
-function _nonIterableRest() {
-  throw new TypeError("Invalid attempt to destructure non-iterable instance");
-}
-
-var number = PDFObject.number;
+var {
+  number
+} = PDFObject;
 
 class PDFGradient {
   constructor(doc) {
@@ -1353,15 +1317,16 @@ class PDFGradient {
 
   embed(m) {
     var fn;
+    var stopsLength = this.stops.length;
 
-    if (this.stops.length === 0) {
+    if (stopsLength === 0) {
       return;
     }
 
     this.embedded = true;
     this.matrix = m; // if the last stop comes before 100%, add a copy at 100%
 
-    var last = this.stops[this.stops.length - 1];
+    var last = this.stops[stopsLength - 1];
 
     if (last[0] < 1) {
       this.stops.push([1, last[1], last[2]]);
@@ -1371,7 +1336,7 @@ class PDFGradient {
     var encode = [];
     var stops = [];
 
-    for (var i = 0, stopsLength = this.stops.length - 1; i < stopsLength; i++) {
+    for (var i = 0; i < stopsLength - 1; i++) {
       encode.push(0, 1);
 
       if (i + 2 !== stopsLength) {
@@ -1390,7 +1355,7 @@ class PDFGradient {
     } // if there are only two stops, we don't need a stitching function
 
 
-    if (stops.length === 1) {
+    if (stopsLength === 1) {
       fn = stops[0];
     } else {
       fn = this.doc.ref({
@@ -1411,7 +1376,7 @@ class PDFGradient {
       Type: 'Pattern',
       PatternType: 2,
       Shading: shader,
-      Matrix: this.matrix.map(v => number(v))
+      Matrix: this.matrix.map(number)
     });
     pattern.end();
 
@@ -1483,22 +1448,8 @@ class PDFGradient {
 
   apply(op) {
     // apply gradient transform to existing document ctm
-    var _this$doc$_ctm = _slicedToArray(this.doc._ctm, 6),
-        m0 = _this$doc$_ctm[0],
-        m1 = _this$doc$_ctm[1],
-        m2 = _this$doc$_ctm[2],
-        m3 = _this$doc$_ctm[3],
-        m4 = _this$doc$_ctm[4],
-        m5 = _this$doc$_ctm[5];
-
-    var _this$transform = _slicedToArray(this.transform, 6),
-        m11 = _this$transform[0],
-        m12 = _this$transform[1],
-        m21 = _this$transform[2],
-        m22 = _this$transform[3],
-        dx = _this$transform[4],
-        dy = _this$transform[5];
-
+    var [m0, m1, m2, m3, m4, m5] = this.doc._ctm;
+    var [m11, m12, m21, m22, dx, dy] = this.transform;
     var m = [m0 * m11 + m2 * m12, m1 * m11 + m3 * m12, m0 * m21 + m2 * m22, m1 * m21 + m3 * m22, m0 * dx + m2 * dy + m4, m1 * dx + m3 * dy + m5];
 
     if (!this.embedded || m.join(' ') !== this.matrix.join(' ')) {
@@ -1569,9 +1520,11 @@ var Gradient = {
   PDFRadialGradient
 };
 
-var PDFGradient$1 = Gradient.PDFGradient,
-    PDFLinearGradient$1 = Gradient.PDFLinearGradient,
-    PDFRadialGradient$1 = Gradient.PDFRadialGradient;
+var {
+  PDFGradient: PDFGradient$1,
+  PDFLinearGradient: PDFLinearGradient$1,
+  PDFRadialGradient: PDFRadialGradient$1
+} = Gradient;
 var ColorMixin = {
   initColor() {
     // The opacity dictionaries
@@ -1701,10 +1654,7 @@ var ColorMixin = {
     var key = "".concat(fillOpacity, "_").concat(strokeOpacity);
 
     if (this._opacityRegistry[key]) {
-      var _this$_opacityRegistr = _slicedToArray(this._opacityRegistry[key], 2);
-
-      dictionary = _this$_opacityRegistr[0];
-      name = _this$_opacityRegistr[1];
+      [dictionary, name] = this._opacityRegistry[key];
     } else {
       dictionary = {
         Type: 'ExtGState'
@@ -2043,7 +1993,7 @@ var runners = {
     cy = a[5];
     px = a[2];
     py = a[3];
-    return doc.bezierCurveTo(...(a || []));
+    return doc.bezierCurveTo(...a);
   },
 
   c(doc, a) {
@@ -2193,20 +2143,12 @@ var runners = {
 };
 
 var solveArc = function solveArc(doc, x, y, coords) {
-  var _coords = _slicedToArray(coords, 7),
-      rx = _coords[0],
-      ry = _coords[1],
-      rot = _coords[2],
-      large = _coords[3],
-      sweep = _coords[4],
-      ex = _coords[5],
-      ey = _coords[6];
-
+  var [rx, ry, rot, large, sweep, ex, ey] = coords;
   var segs = arcToSegments(ex, ey, rx, ry, large, sweep, rot, x, y);
 
   for (var seg of segs) {
-    var bez = segmentToBezier(...(seg || []));
-    doc.bezierCurveTo(...(bez || []));
+    var bez = segmentToBezier(...seg);
+    doc.bezierCurveTo(...bez);
   }
 }; // from Inkscape svgtopdf, thanks!
 
@@ -2296,7 +2238,9 @@ class SVGPath {
 
 }
 
-var number$1 = PDFObject.number; // This constant is used to approximate a symmetrical arc using a cubic
+var {
+  number: number$1
+} = PDFObject; // This constant is used to approximate a symmetrical arc using a cubic
 // Bezier curve.
 
 var KAPPA = 4.0 * ((Math.sqrt(2) - 1.0) / 3.0);
@@ -2580,15 +2524,7 @@ var VectorMixin = {
   transform(m11, m12, m21, m22, dx, dy) {
     // keep track of the current transformation matrix
     var m = this._ctm;
-
-    var _m = _slicedToArray(m, 6),
-        m0 = _m[0],
-        m1 = _m[1],
-        m2 = _m[2],
-        m3 = _m[3],
-        m4 = _m[4],
-        m5 = _m[5];
-
+    var [m0, m1, m2, m3, m4, m5] = m;
     m[0] = m0 * m11 + m2 * m12;
     m[1] = m1 * m11 + m3 * m12;
     m[2] = m0 * m21 + m2 * m22;
@@ -2612,10 +2548,7 @@ var VectorMixin = {
     var x = y = 0;
 
     if (options.origin != null) {
-      var _options$origin = _slicedToArray(options.origin, 2);
-
-      x = _options$origin[0];
-      y = _options$origin[1];
+      [x, y] = options.origin;
       var x1 = x * cos - y * sin;
       var y1 = x * sin + y * cos;
       x -= x1;
@@ -2641,10 +2574,7 @@ var VectorMixin = {
     var x = y = 0;
 
     if (options.origin != null) {
-      var _options$origin2 = _slicedToArray(options.origin, 2);
-
-      x = _options$origin2[0];
-      y = _options$origin2[1];
+      [x, y] = options.origin;
       x -= xFactor * x;
       y -= yFactor * y;
     }
@@ -2920,13 +2850,14 @@ class StandardFont extends PDFFont {
     this.name = name;
     this.id = id;
     this.font = new AFMFont(STANDARD_FONTS[this.name]());
-    var _this$font = this.font;
-    this.ascender = _this$font.ascender;
-    this.descender = _this$font.descender;
-    this.bbox = _this$font.bbox;
-    this.lineGap = _this$font.lineGap;
-    this.xHeight = _this$font.xHeight;
-    this.capHeight = _this$font.capHeight;
+    ({
+      ascender: this.ascender,
+      descender: this.descender,
+      bbox: this.bbox,
+      lineGap: this.lineGap,
+      xHeight: this.xHeight,
+      capHeight: this.capHeight
+    } = this.font);
   }
 
   embed() {
@@ -3077,10 +3008,10 @@ class EmbeddedFont extends PDFFont {
   }
 
   encode(text, features) {
-    var _this$layout = this.layout(text, features),
-        glyphs = _this$layout.glyphs,
-        positions = _this$layout.positions;
-
+    var {
+      glyphs,
+      positions
+    } = this.layout(text, features);
     var res = [];
 
     for (var i = 0; i < glyphs.length; i++) {
@@ -3139,7 +3070,9 @@ class EmbeddedFont extends PDFFont {
 
     var tag = [1, 2, 3, 4, 5, 6].map(i => String.fromCharCode((this.id.charCodeAt(i) || 74) + 16)).join('');
     var name = tag + '+' + this.font.postscriptName;
-    var bbox = this.font.bbox;
+    var {
+      bbox
+    } = this.font;
     var descriptor = this.document.ref({
       Type: 'FontDescriptor',
       FontName: name,
@@ -3160,9 +3093,9 @@ class EmbeddedFont extends PDFFont {
     }
 
     descriptor.end();
-    var descendantFont = this.document.ref({
+    var descendantFontData = {
       Type: 'Font',
-      Subtype: isCFF ? 'CIDFontType0' : 'CIDFontType2',
+      Subtype: 'CIDFontType0',
       BaseFont: name,
       CIDSystemInfo: {
         Registry: new String('Adobe'),
@@ -3171,7 +3104,14 @@ class EmbeddedFont extends PDFFont {
       },
       FontDescriptor: descriptor,
       W: [0, this.widths]
-    });
+    };
+
+    if (!isCFF) {
+      descendantFontData.Subtype = 'CIDFontType2';
+      descendantFontData.CIDToGIDMap = 'Identity';
+    }
+
+    var descendantFont = this.document.ref(descendantFontData);
     descendantFont.end();
     this.dictionary.data = {
       Type: 'Font',
@@ -3269,9 +3209,10 @@ var FontsMixin = {
 
     if (typeof src === 'string' && this._registeredFonts[src]) {
       cacheKey = src;
-      var _this$_registeredFont = this._registeredFonts[src];
-      src = _this$_registeredFont.src;
-      family = _this$_registeredFont.family;
+      ({
+        src,
+        family
+      } = this._registeredFonts[src]);
     } else {
       cacheKey = family || src;
 
@@ -3384,7 +3325,9 @@ class LineWrapper extends EventEmitter {
     }); // handle left aligning last lines of paragraphs
 
     this.on('lastLine', options => {
-      var align = options.align;
+      var {
+        align
+      } = options;
 
       if (align === 'justify') {
         options.align = 'left';
@@ -3446,6 +3389,11 @@ class LineWrapper extends EventEmitter {
               mustShrink = w > this.spaceLeft && l > 0;
               mightGrow = w <= this.spaceLeft && l < word.length;
             }
+          } // check for the edge case where a single character cannot fit into a line.
+
+
+          if (l === 0 && this.spaceLeft === this.lineWidth) {
+            l = 1;
           } // send a required break unless this is the last piece and a linebreak is not specified
 
 
@@ -3506,13 +3454,17 @@ class LineWrapper extends EventEmitter {
     var textWidth = 0;
     var wc = 0;
     var lc = 0;
-    var y = this.document.y; // used to reset Y pos if options.continued (below)
+    var {
+      y
+    } = this.document; // used to reset Y pos if options.continued (below)
 
     var emitLine = () => {
       options.textWidth = textWidth + this.wordSpacing * (wc - 1);
       options.wordCount = wc;
       options.lineWidth = this.lineWidth;
-      y = this.document.y;
+      ({
+        y
+      } = this.document);
       this.emit('line', buffer, options, this);
       return lc++;
     };
@@ -3638,7 +3590,7 @@ class LineWrapper extends EventEmitter {
       this.document.x = this.startX;
 
       if (this.document._fillColor) {
-        this.document.fillColor(...(this.document._fillColor || []));
+        this.document.fillColor(...this.document._fillColor);
       }
 
       this.emit('pageBreak', options, this);
@@ -3654,7 +3606,9 @@ class LineWrapper extends EventEmitter {
 
 }
 
-var number$2 = PDFObject.number;
+var {
+  number: number$2
+} = PDFObject;
 var TextMixin = {
   initText() {
     this._line = this._line.bind(this); // Current coordinates
@@ -3727,8 +3681,10 @@ var TextMixin = {
   },
 
   heightOfString(text, options) {
-    var x = this.x,
-        y = this.y;
+    var {
+      x,
+      y
+    } = this;
     options = this._initOptions(options);
     options.height = Infinity; // don't break pages
 
@@ -3850,7 +3806,7 @@ var TextMixin = {
         var val = this._textOptions[key];
 
         if (key !== 'continued') {
-          if (result[key] == null) {
+          if (result[key] === undefined) {
             result[key] = val;
           }
         }
@@ -3871,6 +3827,8 @@ var TextMixin = {
       if (result.width == null) {
         result.width = this.page.width - this.x - this.page.margins.right;
       }
+
+      result.width = Math.max(result.width, 0);
     }
 
     if (!result.columns) {
@@ -4068,10 +4026,7 @@ var TextMixin = {
       positions = [];
 
       for (var word of words) {
-        var _this$_font$encode = this._font.encode(word, options.features),
-            _this$_font$encode2 = _slicedToArray(_this$_font$encode, 2),
-            encodedWord = _this$_font$encode2[0],
-            positionsWord = _this$_font$encode2[1];
+        var [encodedWord, positionsWord] = this._font.encode(word, options.features);
 
         encoded = encoded.concat(encodedWord);
         positions = positions.concat(positionsWord); // add the word spacing to the end of the word
@@ -4089,12 +4044,7 @@ var TextMixin = {
         positions[positions.length - 1] = space;
       }
     } else {
-      var _this$_font$encode3 = this._font.encode(text, options.features);
-
-      var _this$_font$encode4 = _slicedToArray(_this$_font$encode3, 2);
-
-      encoded = _this$_font$encode4[0];
-      positions = _this$_font$encode4[1];
+      [encoded, positions] = this._font.encode(text, options.features);
     }
 
     var scale = this._fontSize / 1000;
@@ -4244,6 +4194,7 @@ class PNGImage {
   }
 
   embed(document) {
+    var dataDecoded = false;
     this.document = document;
 
     if (this.obj) {
@@ -4251,6 +4202,7 @@ class PNGImage {
     }
 
     var hasAlphaChannel = this.image.hasAlphaChannel;
+    var isInterlaced = this.image.interlaceMethod === 1;
     this.obj = this.document.ref({
       Type: 'XObject',
       Subtype: 'Image',
@@ -4262,7 +4214,7 @@ class PNGImage {
 
     if (!hasAlphaChannel) {
       var params = this.document.ref({
-        Predictor: 15,
+        Predictor: isInterlaced ? 1 : 15,
         Colors: this.image.colors,
         BitsPerComponent: this.image.bits,
         Columns: this.width
@@ -4291,7 +4243,9 @@ class PNGImage {
     } else if (this.image.transparency.rgb) {
       // Use Color Key Masking (spec section 4.8.5)
       // An array with N elements, where N is two times the number of color components.
-      var rgb = this.image.transparency.rgb;
+      var {
+        rgb
+      } = this.image.transparency;
       var mask = [];
 
       for (var x of rgb) {
@@ -4302,14 +4256,20 @@ class PNGImage {
     } else if (this.image.transparency.indexed) {
       // Create a transparency SMask for the image based on the data
       // in the PLTE and tRNS sections. See below for details on SMasks.
+      dataDecoded = true;
       return this.loadIndexedAlphaChannel();
     } else if (hasAlphaChannel) {
       // For PNG color types 4 and 6, the transparency data is stored as a alpha
       // channel mixed in with the main image data. Separate this data out into an
       // SMask object and store it separately in the PDF.
+      dataDecoded = true;
       return this.splitAlphaChannel();
     }
 
+    if (isInterlaced && !dataDecoded) {
+      return this.decodeData();
+    }
+
     this.finalize();
   }
 
@@ -4379,11 +4339,18 @@ class PNGImage {
     });
   }
 
+  decodeData() {
+    this.image.decodePixels(pixels => {
+      this.imgData = zlib.deflateSync(pixels);
+      this.finalize();
+    });
+  }
+
 }
 
-/*
-PDFImage - embeds images in PDF documents
-By Devon Govett
+/*
+PDFImage - embeds images in PDF documents
+By Devon Govett
 */
 
 class PDFImage {
@@ -4472,10 +4439,7 @@ var ImagesMixin = {
       w = image.width * options.scale;
       h = image.height * options.scale;
     } else if (options.fit) {
-      var _options$fit = _slicedToArray(options.fit, 2);
-
-      bw = _options$fit[0];
-      bh = _options$fit[1];
+      [bw, bh] = options.fit;
       bp = bw / bh;
       ip = image.width / image.height;
 
@@ -4487,10 +4451,7 @@ var ImagesMixin = {
         w = bh * ip;
       }
     } else if (options.cover) {
-      var _options$cover = _slicedToArray(options.cover, 2);
-
-      bw = _options$cover[0];
-      bh = _options$cover[1];
+      [bw, bh] = options.cover;
       bp = bw / bh;
       ip = image.width / image.height;
 
@@ -4568,6 +4529,10 @@ var AnnotationsMixin = {
     options.Rect = this._convertRect(x, y, w, h);
     options.Border = [0, 0, 0];
 
+    if (options.Subtype === 'Link' && typeof options.F === 'undefined') {
+      options.F = 1 << 2; // Print Annotation Flag
+    }
+
     if (options.Subtype !== 'Link') {
       if (options.C == null) {
         options.C = this._normalizeColor(options.color || [0, 0, 0]);
@@ -4649,12 +4614,7 @@ var AnnotationsMixin = {
   _markup(x, y, w, h) {
     var options = arguments.length > 4 && arguments[4] !== undefined ? arguments[4] : {};
 
-    var _this$_convertRect = this._convertRect(x, y, w, h),
-        _this$_convertRect2 = _slicedToArray(_this$_convertRect, 4),
-        x1 = _this$_convertRect2[0],
-        y1 = _this$_convertRect2[1],
-        x2 = _this$_convertRect2[2],
-        y2 = _this$_convertRect2[3];
+    var [x1, y1, x2, y2] = this._convertRect(x, y, w, h);
 
     options.QuadPoints = [x1, y2, x2, y2, x1, y1, x2, y1];
     options.Contents = new String();
@@ -4721,14 +4681,7 @@ var AnnotationsMixin = {
 
     var x2 = x1 + w; // apply current transformation matrix to points
 
-    var _this$_ctm = _slicedToArray(this._ctm, 6),
-        m0 = _this$_ctm[0],
-        m1 = _this$_ctm[1],
-        m2 = _this$_ctm[2],
-        m3 = _this$_ctm[3],
-        m4 = _this$_ctm[4],
-        m5 = _this$_ctm[5];
-
+    var [m0, m1, m2, m3, m4, m5] = this._ctm;
     x1 = m0 * x1 + m2 * y1 + m4;
     y1 = m1 * x1 + m3 * y1 + m5;
     x2 = m0 * x2 + m2 * y2 + m4;
@@ -4819,9 +4772,443 @@ var OutlineMixin = {
 
 };
 
-/*
-PDFDocument - represents an entire PDF document
-By Devon Govett
+var FIELD_FLAGS = {
+  readOnly: 1,
+  required: 2,
+  noExport: 4,
+  multiline: 0x1000,
+  password: 0x2000,
+  toggleToOffButton: 0x4000,
+  radioButton: 0x8000,
+  pushButton: 0x10000,
+  combo: 0x20000,
+  edit: 0x40000,
+  sort: 0x80000,
+  multiSelect: 0x200000,
+  noSpell: 0x400000
+};
+var FIELD_JUSTIFY = {
+  left: 0,
+  center: 1,
+  right: 2
+};
+var VALUE_MAP = {
+  value: 'V',
+  defaultValue: 'DV'
+};
+var FORMAT_SPECIAL = {
+  zip: '0',
+  zipPlus4: '1',
+  zip4: '1',
+  phone: '2',
+  ssn: '3'
+};
+var FORMAT_DEFAULT = {
+  number: {
+    nDec: 0,
+    sepComma: false,
+    negStyle: 'MinusBlack',
+    currency: '',
+    currencyPrepend: true
+  },
+  percent: {
+    nDec: 0,
+    sepComma: false
+  }
+};
+var AcroFormMixin = {
+  /**
+   * Must call if adding AcroForms to a document. Must also call font() before
+   * this method to set the default font.
+   */
+  initForm() {
+    if (!this._font) {
+      throw new Error('Must set a font before calling initForm method');
+    }
+
+    this._acroform = {
+      fonts: {},
+      defaultFont: this._font.name
+    };
+    this._acroform.fonts[this._font.id] = this._font.ref();
+    var data = {
+      Fields: [],
+      NeedAppearances: true,
+      DA: new String("/".concat(this._font.id, " 0 Tf 0 g")),
+      DR: {
+        Font: {}
+      }
+    };
+    data.DR.Font[this._font.id] = this._font.ref();
+    var AcroForm = this.ref(data);
+    this._root.data.AcroForm = AcroForm;
+    return this;
+  },
+
+  /**
+   * Called automatically by document.js
+   */
+  endAcroForm() {
+    if (this._root.data.AcroForm) {
+      if (!Object.keys(this._acroform.fonts).length && !this._acroform.defaultFont) {
+        throw new Error('No fonts specified for PDF form');
+      }
+
+      var fontDict = this._root.data.AcroForm.data.DR.Font;
+      Object.keys(this._acroform.fonts).forEach(name => {
+        fontDict[name] = this._acroform.fonts[name];
+      });
+
+      this._root.data.AcroForm.data.Fields.forEach(fieldRef => {
+        this._endChild(fieldRef);
+      });
+
+      this._root.data.AcroForm.end();
+    }
+
+    return this;
+  },
+
+  _endChild(ref) {
+    if (Array.isArray(ref.data.Kids)) {
+      ref.data.Kids.forEach(childRef => {
+        this._endChild(childRef);
+      });
+      ref.end();
+    }
+
+    return this;
+  },
+
+  /**
+   * Creates and adds a form field to the document. Form fields are intermediate
+   * nodes in a PDF form that are used to specify form name heirarchy and form
+   * value defaults.
+   * @param {string} name - field name (T attribute in field dictionary)
+   * @param {object} options  - other attributes to include in field dictionary
+   */
+  formField(name) {
+    var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+
+    var fieldDict = this._fieldDict(name, null, options);
+
+    var fieldRef = this.ref(fieldDict);
+
+    this._addToParent(fieldRef);
+
+    return fieldRef;
+  },
+
+  /**
+   * Creates and adds a Form Annotation to the document. Form annotations are
+   * called Widget annotations internally within a PDF file.
+   * @param {string} name - form field name (T attribute of widget annotation
+   * dictionary)
+   * @param {number} x
+   * @param {number} y
+   * @param {number} w
+   * @param {number} h
+   * @param {object} options
+   */
+  formAnnotation(name, type, x, y, w, h) {
+    var options = arguments.length > 6 && arguments[6] !== undefined ? arguments[6] : {};
+
+    var fieldDict = this._fieldDict(name, type, options);
+
+    fieldDict.Subtype = 'Widget';
+
+    if (fieldDict.F === undefined) {
+      fieldDict.F = 4; // print the annotation
+    } // Add Field annot to page, and get it's ref
+
+
+    this.annotate(x, y, w, h, fieldDict);
+    var annotRef = this.page.annotations[this.page.annotations.length - 1];
+    return this._addToParent(annotRef);
+  },
+
+  formText(name, x, y, w, h) {
+    var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
+    return this.formAnnotation(name, 'text', x, y, w, h, options);
+  },
+
+  formPushButton(name, x, y, w, h) {
+    var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
+    return this.formAnnotation(name, 'pushButton', x, y, w, h, options);
+  },
+
+  formCombo(name, x, y, w, h) {
+    var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
+    return this.formAnnotation(name, 'combo', x, y, w, h, options);
+  },
+
+  formList(name, x, y, w, h) {
+    var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
+    return this.formAnnotation(name, 'list', x, y, w, h, options);
+  },
+
+  formRadioButton(name, x, y, w, h) {
+    var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
+    return this.formAnnotation(name, 'radioButton', x, y, w, h, options);
+  },
+
+  formCheckbox(name, x, y, w, h) {
+    var options = arguments.length > 5 && arguments[5] !== undefined ? arguments[5] : {};
+    return this.formAnnotation(name, 'checkbox', x, y, w, h, options);
+  },
+
+  _addToParent(fieldRef) {
+    var parent = fieldRef.data.Parent;
+
+    if (parent) {
+      if (!parent.data.Kids) {
+        parent.data.Kids = [];
+      }
+
+      parent.data.Kids.push(fieldRef);
+    } else {
+      this._root.data.AcroForm.data.Fields.push(fieldRef);
+    }
+
+    return this;
+  },
+
+  _fieldDict(name, type) {
+    var options = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : {};
+
+    if (!this._acroform) {
+      throw new Error('Call document.initForms() method before adding form elements to document');
+    }
+
+    var opts = Object.assign({}, options);
+
+    if (type !== null) {
+      opts = this._resolveType(type, options);
+    }
+
+    opts = this._resolveFlags(opts);
+    opts = this._resolveJustify(opts);
+    opts = this._resolveFont(opts);
+    opts = this._resolveStrings(opts);
+    opts = this._resolveColors(opts);
+    opts = this._resolveFormat(opts);
+    opts.T = new String(name);
+
+    if (opts.parent) {
+      opts.Parent = opts.parent;
+      delete opts.parent;
+    }
+
+    return opts;
+  },
+
+  _resolveType(type, opts) {
+    if (type === 'text') {
+      opts.FT = 'Tx';
+    } else if (type === 'pushButton') {
+      opts.FT = 'Btn';
+      opts.pushButton = true;
+    } else if (type === 'radioButton') {
+      opts.FT = 'Btn';
+      opts.radioButton = true;
+    } else if (type === 'checkbox') {
+      opts.FT = 'Btn';
+    } else if (type === 'combo') {
+      opts.FT = 'Ch';
+      opts.combo = true;
+    } else if (type === 'list') {
+      opts.FT = 'Ch';
+    } else {
+      throw new Error("Invalid form annotation type '".concat(type, "'"));
+    }
+
+    return opts;
+  },
+
+  _resolveFormat(opts) {
+    var f = opts.format;
+
+    if (f && f.type) {
+      var fnKeystroke;
+      var fnFormat;
+      var params = '';
+
+      if (FORMAT_SPECIAL[f.type] !== undefined) {
+        fnKeystroke = "AFSpecial_Keystroke";
+        fnFormat = "AFSpecial_Format";
+        params = FORMAT_SPECIAL[f.type];
+      } else {
+        var format = f.type.charAt(0).toUpperCase() + f.type.slice(1);
+        fnKeystroke = "AF".concat(format, "_Keystroke");
+        fnFormat = "AF".concat(format, "_Format");
+
+        if (f.type === 'date') {
+          fnKeystroke += 'Ex';
+          params = String(f.param);
+        } else if (f.type === 'time') {
+          params = String(f.param);
+        } else if (f.type === 'number') {
+          var p = Object.assign({}, FORMAT_DEFAULT.number, f);
+          params = String([String(p.nDec), p.sepComma ? '0' : '1', '"' + p.negStyle + '"', 'null', '"' + p.currency + '"', String(p.currencyPrepend)].join(','));
+        } else if (f.type === 'percent') {
+          var _p = Object.assign({}, FORMAT_DEFAULT.percent, f);
+
+          params = String([String(_p.nDec), _p.sepComma ? '0' : '1'].join(','));
+        }
+      }
+
+      opts.AA = opts.AA ? opts.AA : {};
+      opts.AA.K = {
+        S: 'JavaScript',
+        JS: new String("".concat(fnKeystroke, "(").concat(params, ");"))
+      };
+      opts.AA.F = {
+        S: 'JavaScript',
+        JS: new String("".concat(fnFormat, "(").concat(params, ");"))
+      };
+    }
+
+    delete opts.format;
+    return opts;
+  },
+
+  _resolveColors(opts) {
+    var color = this._normalizeColor(opts.backgroundColor);
+
+    if (color) {
+      if (!opts.MK) {
+        opts.MK = {};
+      }
+
+      opts.MK.BG = color;
+    }
+
+    color = this._normalizeColor(opts.borderColor);
+
+    if (color) {
+      if (!opts.MK) {
+        opts.MK = {};
+      }
+
+      opts.MK.BC = color;
+    }
+
+    delete opts.backgroundColor;
+    delete opts.borderColor;
+    return opts;
+  },
+
+  _resolveFlags(options) {
+    var result = 0;
+    Object.keys(options).forEach(key => {
+      if (FIELD_FLAGS[key]) {
+        result |= FIELD_FLAGS[key];
+        delete options[key];
+      }
+    });
+
+    if (result !== 0) {
+      options.Ff = options.Ff ? options.Ff : 0;
+      options.Ff |= result;
+    }
+
+    return options;
+  },
+
+  _resolveJustify(options) {
+    var result = 0;
+
+    if (options.align !== undefined) {
+      if (typeof FIELD_JUSTIFY[options.align] === 'number') {
+        result = FIELD_JUSTIFY[options.align];
+      }
+
+      delete options.align;
+    }
+
+    if (result !== 0) {
+      options.Q = result; // default
+    }
+
+    return options;
+  },
+
+  _resolveFont(options) {
+    // add current font to document-level AcroForm dict if necessary
+    if (this._acroform.fonts[this._font.id] === null) {
+      this._acroform.fonts[this._font.id] = this._font.ref();
+    } // add current font to field's resource dict (RD) if not the default acroform font
+
+
+    if (this._acroform.defaultFont !== this._font.name) {
+      options.DR = {
+        Font: {}
+      };
+      options.DR.Font[this._font.id] = this._font.ref();
+      options.DA = new String("/".concat(this._font.id, " 0 Tf 0 g"));
+    }
+
+    return options;
+  },
+
+  _resolveStrings(options) {
+    var select = [];
+
+    function appendChoices(a) {
+      if (Array.isArray(a)) {
+        for (var idx = 0; idx < a.length; idx++) {
+          if (typeof a[idx] === 'string') {
+            select.push(new String(a[idx]));
+          } else {
+            select.push(a[idx]);
+          }
+        }
+      }
+    }
+
+    appendChoices(options.Opt);
+
+    if (options.select) {
+      appendChoices(options.select);
+      delete options.select;
+    }
+
+    if (select.length) {
+      options.Opt = select;
+    }
+
+    if (options.value || options.defaultValue) ;
+
+    Object.keys(VALUE_MAP).forEach(key => {
+      if (options[key] !== undefined) {
+        options[VALUE_MAP[key]] = options[key];
+        delete options[key];
+      }
+    });
+    ['V', 'DV'].forEach(key => {
+      if (typeof options[key] === 'string') {
+        options[key] = new String(options[key]);
+      }
+    });
+
+    if (options.MK && options.MK.CA) {
+      options.MK.CA = new String(options.MK.CA);
+    }
+
+    if (options.label) {
+      options.MK = options.MK ? options.MK : {};
+      options.MK.CA = new String(options.label);
+      delete options.label;
+    }
+
+    return options;
+  }
+
+};
+
+/*
+PDFDocument - represents an entire PDF document
+By Devon Govett
 */
 
 class PDFDocument extends stream.Readable {
@@ -4918,7 +5305,9 @@ class PDFDocument extends stream.Readable {
   addPage(options) {
     // end the current page if needed
     if (options == null) {
-      options = this.options;
+      ({
+        options
+      } = this);
     }
 
     if (!this.options.bufferPages) {
@@ -4992,6 +5381,19 @@ class PDFDocument extends stream.Readable {
     this._root.data.Names.data.Dests.add(name, args);
   }
 
+  addNamedJavaScript(name, js) {
+    if (!this._root.data.Names.data.JavaScript) {
+      this._root.data.Names.data.JavaScript = new PDFNameTree();
+    }
+
+    var data = {
+      JS: new String(js),
+      S: 'JavaScript'
+    };
+
+    this._root.data.Names.data.JavaScript.add(name, data);
+  }
+
   ref(data) {
     var ref = new PDFReference(this, this._offsets.length + 1, data);
 
@@ -5069,6 +5471,8 @@ class PDFDocument extends stream.Readable {
 
     this._root.data.Names.end();
 
+    this.endAcroForm();
+
     if (this._security) {
       this._security.end();
     }
@@ -5139,6 +5543,7 @@ mixin(TextMixin);
 mixin(ImagesMixin);
 mixin(AnnotationsMixin);
 mixin(OutlineMixin);
+mixin(AcroFormMixin);
 
 export default PDFDocument;
 //# sourceMappingURL=pdfkit.esnext.js.map